home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / OS2 / XHS611.ZIP / XHS6.DOC < prev   
Encoding:
Text File  |  1994-02-08  |  105.3 KB  |  2,370 lines
  1.  
  2.  
  3.                     ╒══════════════════════════════╕
  4.                     │  THS - TNC Hostmode Server   │
  5.                     │ PHS - PK-xxx Hostmode Server │
  6.                     ╘══════════════════════════════╛
  7.  
  8.                 HB9CVV
  9.                  January 1994
  10.  
  11.                           Version 6.1x - OS/2
  12.  
  13.     THS is an OS/2 Packet Radio terminal program to control a TNC-1 or
  14.     TNC-2 with the WA8DED or equivalent Firmware.
  15.  
  16.     PHS is an OS/2 Packet Radio terminal program to control a PK-232 or
  17.     PK-900 multi-mode terminal node controller. The firmware of the
  18.     PK firmware must be dated 30.DEC.88 or later.
  19.  
  20.     Both programs are 32-bit textmode applications and run either in an
  21.     OS/2 full screen or in an OS/2 window under OS/2 2.x only.
  22.  
  23.  
  24.              Major features of THS/PHS
  25.              ═════════════════════════
  26.  
  27.     * PHS: support of packet, amtor, rtty, ascii, morse, signal and
  28.       pactor modes (depending on firmware).
  29.     * PHS: supports both radio modems of a PK-900 simultanuesly.
  30.     * user configurable comm-port, colors and texts.
  31.     * split screen operation.
  32.     * command and parameter entry in mode sensitive dialog windows.
  33.     * extended help functions.
  34.     * review of received text (backscrolling).
  35.     * snapshooting of the review-buffer to file.
  36.     * logging (capturing) to file.
  37.     * send text from file.
  38.     * binary file transfer using YAPP protocol (packet mode).
  39.     * multi-channel operation (packet mode).
  40.     * heard list showing the path (packet mode).
  41.     * Net/Rom frames are decoded (packet mode).
  42.     * wordwrapping is available.
  43.     * built-in message editor.
  44.     * support for screens up to 80*60.
  45.  
  46.     THS contains a subset of the features of PHS because the TNC is
  47.     packet mode only.
  48.  
  49.     For PHS, the document describes the operation for the PK-232. A
  50.     PK-900 can be operated like a PK-232, but only the first modem
  51.     ("Radio 1") is serviced in this case. For the 'true' PK-900
  52.     operation, please see the appendix.
  53.  
  54.  
  55.         ******************************************************************
  56.         * A note to PK-900 users: It is highly recommended NOT to use    *
  57.         * the PK-900 at a communication line speed of 19200 baud, but    *
  58.         * use 9600 baud only. The PK-900 seems to have problems at 19200 *
  59.         * baud (which can be seen by the use of a line monitor).         *
  60.         ******************************************************************
  61.  
  62.  
  63.  
  64.             NOTE
  65.             ════════════
  66.  
  67.     XHS is a hobby project and covers my needs, so I implemented the
  68.     features which I wished to have, and did not bother to fit all tastes
  69.     and to match all possibilities.  XHS may well be not adequate for
  70.     your requirements, please remember however that you are not forced to
  71.     use it, nor did you have to pay for it.
  72.  
  73.  
  74.  
  75.           Changes and modifications since version 4.03
  76.           ════════════════════════════════════════════
  77.  
  78.     6.11  Silly bug removed which prevents older firmware which is not
  79.           able to understand the newer "HOST 5" command (but only 
  80.           "HOST Y/N" to be recognized.
  81.  
  82.         6.1   Added support for the 01-DEC-93 firmware from AEA. Users of
  83.               older firmware which is not supporting all commands will see
  84.               some error messages for the unsupported commands during
  85.               startup when PHS loads the PK-xxx parameters. These 
  86.               unsupported commands are simply marked "unsupported" by PHS 
  87.               and consequently are not available.
  88.  
  89.               The Help message file has not been edited for the new commands
  90.               yet, I am tired of typing manual pages. Anybody willing to do
  91.           this (if you look into the help-files, the format is obvious)
  92.           is invited to send it to me for incorporation...
  93.  
  94.               Due to the common source code, THS also got the version 
  95.               number 6.1, but has not experienced any changes.
  96.  
  97.         6.02  Corrected program aborts caused by weird responses of the
  98.               PK-900 firmware to CO commands. Using IBM C/C++ Tools now.
  99.  
  100.     6.00  Added support for the PK-900 (two modems). Ported XHS for
  101.           compilation with the IBM CSet 32-bit compiler. Version 6 will
  102.           now require OS/2 2.x and will not run under OS/2 1.x.
  103.  
  104.     5.00  Added Pactor mode support for the PK-232 01-MAR-93 firmware.
  105.  
  106.           Added word-wrapping for word-oriented (i.e. non-Packet)
  107.           modes.
  108.  
  109.  
  110.  
  111.  
  112.                         PRINCIPLES OF OPERATION
  113.                         ═══════════════════════
  114.  
  115.     THS/PHS have been developed from the equivalent, older DOS programs.
  116.     The term "XHS" is also used for "THS or/and PHS".
  117.  
  118.     XHS uses the OS/2 Communications driver for the RS-232 line to the
  119.     terminal device and make full use if a buffered hardware port is
  120.     available.
  121.  
  122.     XHS runs the firmware software exclusively in HOST mode, which
  123.     permits a maxiumum of control and cooperation. XHS is written in C
  124.     for the IBM C-Set compiler.
  125.  
  126.     The internal implementation of XHS in form of several concurrent
  127.     threads. This permits full parallel service of communications
  128.     control, screen, and keyboard - you will never notice delays when you
  129.     type (opposed to other similar programs).
  130.  
  131.     The windowing system is implemented using the VITAMIN C library (with
  132.     modifications), a commercially available software library.  Vitamin C
  133.     permits writing to non-active windows, so scrolling in an underlying
  134.     window is possible.
  135.  
  136.     This feature, together with the real-time operation, permits to
  137.     continue the receiving and displaying of received packets even when
  138.     support windows (e.g.  help windows or parameter dialog windows) are
  139.     opened.
  140.  
  141.     The PK-232 device or the TNC device are also called "device" or "TNC"
  142.     in this document.
  143.  
  144.  
  145.                               INSTALLATION
  146.                               ════════════
  147.  
  148.     It is expected that you are familiar with the operation of the TNC or
  149.     the PK-232 and with the documents describing that software.
  150.  
  151.     PHS consists of the following files:
  152.  
  153.             PHS.EXE         PK-232 Hostmode Server.
  154.         PHS.CFG        Configuration file.
  155.         PHSHELP.MSG    Help file.
  156.         PHSHELP.IDX    Index file.
  157.             XHS6.DOC        Document file
  158.  
  159.     THS consists of the following files:
  160.  
  161.             THS.EXE         TNC Hostmode Server.
  162.         THS.CFG        Configuration file.
  163.         THSHELP.MSG    Help file.
  164.         THSHELP.IDX    Index file.
  165.             XHS6.DOC        Document file
  166.  
  167.     The first four files must reside in the same directory. Before you
  168.     can run THS or PHS, you MUST edit the configuration file THS.CFG or
  169.     PHS.CFG respectively, to reflect YOUR environment, and possibly you
  170.     might have to configure your TNC or PK-232 also.  Please refer to the
  171.     description of the configuration file at the end of this manual.
  172.  
  173.     The syntax to call THS/PHS is: "THS [filename]", or "PHS [filename]"
  174.     where filename is the name of a configuration file. If filename is
  175.     omitted, PHS will use the default filename PHS.CFG, and THS will use
  176.     THS.CFG.
  177.  
  178.     The TNC and the PK-232 both have a support battery to buffer the
  179.     parameter values.  If you use this battery, some TNC/PK-232 parameter
  180.     must be preset to values which allow THS/PHS to communicate with the
  181.     TNC/PK-232. The communication line parameters of the TNC/PK-232 must
  182.     be set to 8 bits, no parity, and the line speed must match the
  183.     selected line speed for THS/PHS.
  184.  
  185.     Alternatively, when no battery is connected, PHS will switch the
  186.     PK-232 to the selected line speed of PHS.
  187.  
  188.     Though not neccessarily required for hostmode operation THS/PHS
  189.     requires the standard 8-wire connection (lines 2-8 and 20) for the
  190.     RS-232 communication line.  You can however override this requirement
  191.     by a parameter in the configuration file (and loose the detection if
  192.     the device is online).
  193.  
  194.     The following chapters describe the operation of PHS. THS is a
  195.     functional subset of PHS because a TNC-1 or TNC-2 operates in packet
  196.     mode only, so part of the features of PHS are not available for THS.
  197.  
  198.  
  199.  
  200.                         PHS OPERATION
  201.                         ═════════════
  202.  
  203.     After you invoked PHS, you get the PHS opening screen:
  204. ───────────────────────────────────────────────────────────────────────────────
  205.  
  206.  
  207.  
  208.      ╒══════════ PK-232 Host mode Server V6.00 [OS/2] - HB9CVV ════════════╕
  209.      │                                                                     │
  210.      │  Initializing COM3, 9600bd - DSR: on, CTS: on, CD: on, FIFO: yes    │
  211.      │  Initializing PK-232 - please wait........done.                     │
  212.      │  PK-232 eprom date is: 01-MAR-93.                                   │
  213.      │  Loading TNC parameters: done.                                      │
  214.      │  Loading CFG parameters: done.                                      │
  215.      │  READY. Use ALT/Z for help.                                         │
  216.      │                                                                     │
  217.      ╘═════════════════════════════════════════════════════════════════════╛
  218.  
  219.  
  220.  
  221.                                                          │    ║ 23-MAR 12:34:56
  222.  
  223.  
  224.  
  225. ───────────────────────────────────────────────────────────────────────────────
  226.  
  227.     PHS will read the number-of-lines of your current video mode from the
  228.     system and adjust its windows accordingly. For all of the screendumps
  229.     shown here, the standard of 25 lines has been used.
  230.  
  231.     The single line with the date and time is the statusline, which is
  232.     normally invers - you cannot see this in this printout. You also see
  233.     that PHS divides the screen into the upper receive window and the
  234.     lower transmit window which are seperated by the statusline. The
  235.     statusline is different for each mode.  During initialisation and for
  236.     a short time during the PK-232 mode switching the statusline is
  237.     blanked in the left part.
  238.  
  239.     You can change the colors of all windows (this includes the
  240.     statusline) by editing the associated values in the configuration
  241.     file.
  242.  
  243.     When this opening screen disappears, PHS switches the PK-232 into the
  244.     initial PK-232 mode, which is also specified in the configuration
  245.     file.
  246.  
  247.     If the RESETDEVICEONEXIT Parameter of the Config-File is NO
  248.     (recommended) the you will realize that PHS temporarily switches the
  249.     PK-232 into the morse mode during the initialisation phase. Also,
  250.     when you exit PHS, the PK-232 is left in the morse mode.
  251.  
  252.     If "FIFO: yes" is displayed, then the OS/2 communications driver
  253.     reported the presence of a buffered asynchronous communictions chip,
  254.     and has enabled the fifo-buffer operation of this chip. Note that
  255.     non-IBM drivers may not report this, but still use a buffered chip.
  256.  
  257.  
  258.                         THE GENERAL KEYS
  259.                         ────────────────
  260.  
  261.     The ESC key is the general help key to call the help window. If you
  262.     press ESC in packet mode, then the packet-mode help screen pops up:
  263.  
  264. ───────────────────────────────────────────────────────────────────────────────
  265.   ╒═══════════════════════════════ PACKET MODE ═══════════════════════════════╕
  266.   │                                     ║                                     │
  267.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  268.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View OS/2 directory         │
  269.   │ ALT/W   Command string directory    ║ ALT/F   View function-key setup     │
  270.   │ ALT/L   Logging (capture) on/off    ║ ALT/R   or  Review (scrollback)    │
  271.   │ ALT/S   Send an ASCII file          ║ ALT/K   Call Editor                 │
  272.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  273.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  274.   │ ALT/M   Switch TNC modes            ║ ESC     Direct command entry        │
  275.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  276.   │ ALT/C   Connect menu                ║ ALT/H   Show formatted heard list   │
  277.   │ ALT/D   Disconnect                  ║ ALT/G   Show raw heard list         │
  278.   │ PgUp    Binary file upload (YAPP)   ║ INS     Toggle status line display  │
  279.   │ PgDn    Binary file download (YAPP) ║ <->     Select Channel              │
  280.   │                                     ║                                     │
  281.   ╘═══════════════════════════════════════════════════════════════════════════╛
  282.  
  283.  
  284.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  285.  
  286.  
  287. ───────────────────────────────────────────────────────────────────────────────
  288.  
  289.     The help window called by ALT/Z is mode sensitive. The upper half of
  290.     the help window (down to the seperator) is identical for all modes
  291.     because the keys are valid in all modes and are called general keys.
  292.     The lower half presents the keys which are mode specific, and are
  293.     called mode keys.
  294.  
  295.     We will now discuss the actions and the support windows caused by the
  296.     general keys presented in the upper part of the help window, followed
  297.     by a discussion of the individual modes and the mode-related keys and
  298.     windows.
  299.  
  300.     Note that when any support window is open and you want to cancel it,
  301.     press any key and the window will disappear. If there is no action
  302.     from the keyboard, any of these windows will also disappear after
  303.     some time.
  304.  
  305.     You will also notice that the activity in the receive window will
  306.     continue when any of the support windows is popped up.
  307.  
  308.  
  309.  
  310.     ALT/P is a general key and available for all modes. It pops up a
  311.     window and shows the PK-232 parameters which are related to the
  312.     currently selected mode.  Consequently, the ALT/P window is discussed
  313.     individually for each mode later.
  314.  
  315.     ALT/I pops up the PK-232 text parameter setup window:
  316.  
  317. ───────────────────────────────────────────────────────────────────────────────
  318.  
  319.  
  320.  
  321.                               ╒═══ SELECT ═══╕
  322.                               │              │
  323.                               │ (A) CFROM    │
  324.                               │ (B) DFROM    │
  325.                               │ (C) MFROM    │
  326.                               │ (D) MTO      │
  327.                               │ (E) UNPROTO  │
  328.                               │ (F) BTEXT    │
  329.                               │ (G) CTEXT    │
  330.                               │ (H) AAB      │
  331.                               │              │
  332.                               ╘══════════════╛
  333.  
  334.  
  335.  
  336.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  337.  
  338.  
  339. ───────────────────────────────────────────────────────────────────────────────
  340.  
  341.     To select the command parameter for inspection or change, you can
  342.     either press the marked character (A, B, C etc), or move the scroll
  343.     bar up and down and then press ENTER (the bar is just not visible in
  344.     this printout).  This window will then disappear and the associated
  345.     parameter entry window will pop up.
  346.  
  347.     This window will pop up regardless of the current PK-232 mode.
  348.  
  349.  
  350.     When you select CFROM, DFROM, MFROM or MTO then the associated
  351.     parameter entry window pops up - for example:
  352.  
  353. ───────────────────────────────────────────────────────────────────────────────
  354.  
  355.  
  356.                  ╒═══ CFROM ════╕
  357.                  │              │
  358.                  │     ALL      │
  359.                  │              │
  360.                  │              │
  361.                  │              │
  362.                  │              │
  363.                  │              │
  364.                  │              │
  365.                  │              │
  366.                  │              │
  367.                  │              │
  368.                  │              │
  369.                  │ <F1>  HELP   │
  370.                  │ <ESC> ABORT  │
  371.                  │ <F10> ACCEPT │
  372.                  │              │
  373.                  │              │
  374.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-MAR 12:34:56
  375.  
  376.   Valid entries are: ALL / NONE / YES / NO
  377. ───────────────────────────────────────────────────────────────────────────────
  378.  
  379.     You can enter a qualifier (ALL, NONE, YES or NO) and a list of
  380.     callsigns.
  381.  
  382.                        Operation of Support Windows
  383.                        ────────────────────────────
  384.  
  385.     For all support windows which show the parameter values of commands,
  386.     PHS always READS the current parameter values first so you can
  387.     inspect the actual values and then apply changes. The cursor is the
  388.     positioned on the first input field, and the size of each input field
  389.     is visible on the screen (which is not visible in the printouts
  390.     here). You move to another commands input field with the down-arrow
  391.     and up-arrow keys. For each command you will always get a short help
  392.     line on the bottom of the screen. If you need more help about the
  393.     command and the parameters, press F1.
  394.  
  395.     With kind permission from AEA, the help texts for the PK-232 commands
  396.     have been derived from manual files supplied by AEA and is
  397.     copyrighted material.
  398.  
  399.     Finally you may press either F10 to accept the data and apply the
  400.     parameter values, or ESC to discard it, in case you changed your
  401.     mind.
  402.  
  403.  
  404.  
  405.     You must follow the rules for the parameters of a command as
  406.     described in the PK-232 manual.  In case of the CFROM window - if you
  407.     enter ALL, followed by a callsign list this makes no sense, and you
  408.     will get an error message from the PK-232:
  409.  
  410. ───────────────────────────────────────────────────────────────────────────────
  411.  
  412.  
  413.                  ╒═══ CFROM ════╕
  414.                  │              │
  415.                  │     ALL      │
  416.                  │              │
  417.                 ╒═══════════════════ TNC: ════════════════════╕
  418.                 │ CFROM - msg from device: "Too many params"  │
  419.                 ╘═════════════════════════════════════════════╛
  420.                  │   HB9DDD     │
  421.                  │   HB9EEE     │
  422.                  │   HB9FFF     │
  423.                  │              │
  424.                  │              │
  425.                  │              │
  426.                  │ <F1>  HELP   │
  427.                  │ <ESC> ABORT  │
  428.                  │ <F10> ACCEPT │
  429.                  │              │
  430.                  │              │
  431.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-MAR 12:34:56
  432.  
  433.  
  434. ───────────────────────────────────────────────────────────────────────────────
  435.  
  436.     MFROM and MTO is preset to "NO", followed by your callsign. The
  437.     reason for this is that PHS monitors when connected, and this
  438.     excludes your own packets from the monitor screen. You should not
  439.     change this if not absolutely neccessary.
  440.  
  441.  
  442.  
  443.     Here is an example of the UNPROTO parameter entry window:
  444.  
  445. ───────────────────────────────────────────────────────────────────────────────
  446.  
  447.                  ╒══ UNPROTO ═══╕
  448.                  │              │
  449.                  │ To:          │
  450.                  │   DB0CZ      │
  451.                  │ via          │
  452.                  │   HB9PD-7    │
  453.                  │   DB0HP      │
  454.                  │              │
  455.                  │              │
  456.                  │              │
  457.                  │              │
  458.                  │              │
  459.                  │              │
  460.                  │              │
  461.                  │ <F1>  HELP   │
  462.                  │ <ESC> ABORT  │
  463.                  │ <F10> ACCEPT │
  464.                  │              │
  465.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-MAR 12:34:56
  466.  
  467.   Callsign and SSID of a digipeater
  468. ───────────────────────────────────────────────────────────────────────────────
  469.  
  470.     In this example the cursor is positioned somewhere in the "via" list
  471.     of callsigns.
  472.  
  473.  
  474.  
  475.     If you selected the BTEXT window, you will get this screen:
  476.  
  477. ───────────────────────────────────────────────────────────────────────────────
  478.  
  479.  
  480.  
  481.  
  482.  
  483.   ╒══════════════════════════════ BEACON TEXT ═══════════════════════════════╕
  484.   │                                                                          │
  485.   │ *** Peter, Qth: Port/Biel - JN37OC                                       │
  486.   │                                                                          │
  487.   │     <F1> HELP    <ESC> ABORT    <CR> or <F10> ACCEPT                     │
  488.   │                                                                          │
  489.   ╘══════════════════════════════════════════════════════════════════════════╛
  490.  
  491.  
  492.  
  493.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  494.  
  495.   Enter beacon text. Use % to clear it
  496. ───────────────────────────────────────────────────────────────────────────────
  497.  
  498.     The initial beacon text has been sent from the beacon string in the
  499.     configuration file during the initialisation phase of PHS. It is read from the
  500.     TNC for presentation, so you will always see the actual beacon text. Note
  501.     however that PHS limits the length of the beacon string to 72 characters.
  502.  
  503.     You will get a similar window for the CONNECT message (CTEXT), and for AAB. The
  504.     input field for CTEXT is also 72 characters, for AAB it is 16 characters.
  505.  
  506.  
  507.  
  508.     The ALT/V key pops up this window which allows you to specify a OS/2 directory
  509.     for viewing, e.g.:
  510.  
  511. ───────────────────────────────────────────────────────────────────────────────
  512.  
  513.      ╒═════════════════════ Directory ══════════════════════╕
  514.      │                                                      │
  515.      │ C:\OS2\*.*                                           │
  516.      │                                                      │
  517.      ╘══════════════════════════════════════════════════════╛
  518.  
  519. ────────────────────────────────── .... ───────────────────────────────────────
  520.  
  521.     Next you will get something like this:
  522.  
  523. ───────────────────────────────────────────────────────────────────────────────
  524.  
  525.  
  526.      ╒═════════════════ DIRECTORY ═════════════════╕
  527.          │                                             │
  528.          │  DOS     .SYS      1536   19-DEC-91  08:13  │
  529.          │  DOSCALLS.LIB     51200   28-NOV-90  21:19  │
  530.      │  E       .EXE     69120   19-DEC-91  06:59  │
  531.      │  EAUTIL  .EXE     38400   19-DEC-91  08:19  │
  532.      │  EPM     .INI       512   08-JAN-92  20:08  │
  533.      │  EXTDSKDD.SYS      2048   19-DEC-91  08:18  │
  534.      │  FDISK   .COM    109568   19-DEC-91  05:41  │
  535.      │  FDISKPM .EXE     72704   19-DEC-91  05:46  │
  536.      │  FIND    .EXE     31744   19-DEC-91  08:22  │
  537.      │  FORMAT  .COM     65024   19-DEC-91  08:44  │
  538.      │  HELP    .CMD      1024   06-AUG-91  10:05  │
  539.      │  HELPMSG .EXE     37888   19-DEC-91  08:27  │
  540.      │  HPFS    .IFS    128512   21-DEC-91  02:14  │
  541.      │  INI     .RC      18944   08-JAN-92  19:41  │
  542.      │  INISYS  .RC       1536   08-JAN-92  19:41  │
  543.      │  KBD01   .SYS     28160   19-DEC-91  08:50  │
  544.      │          ...more...                         │
  545.  M1234 ║N│                                             │║     ║ 24-FEB 16:28:59
  546.      ╘═════════════════════════════════════════════╛
  547.  
  548. ───────────────────────────────────────────────────────────────────────────────
  549.  
  550.  
  551.     ALT/W pops up the command string directory:
  552.  
  553. ───────────────────────────────────────────────────────────────────────────────
  554.                      ╒══════════ COMMAND STRINGS ══════════╕
  555.                      │                                     │
  556.                      │ (A) C DK1SL VIA HB9F                │
  557.                      │ (B) C HB9SDD                        │
  558.                      │ (C) C HB9PD                         │
  559.                      │ (D) C HB9BRC                        │
  560.                      │ (E) C 4U1ITU-8 VIA HB9PD-7, HB9X... │
  561.                      │                                     │
  562.                      ╘═════════════════════════════════════╛
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  572.  
  573.  
  574. ───────────────────────────────────────────────────────────────────────────────
  575.  
  576.     You will see the command string lines from the configuration file
  577.     (these are the lines with the COMMANDSTRING keyword).  The number of
  578.     command strings is limited to 20, and the length of each line is
  579.     limited to 72. Because the width of this window is far less than 72,
  580.     all lines which are too long to fit are truncated for presentation,
  581.     which is indicated by the "...".
  582.  
  583.     Again, to select a command for execution, you can either press the
  584.     marked character (A, B, C etc), or move the scroll bar up and down
  585.     and then press ENTER (the bar is just not visible in this printout).
  586.  
  587.     Quite obviously, a line must contain a valid PK-232 command or you
  588.     will get an error message when you try to execute it. PHS not allow
  589.     the execution of all PK-232 commands - it will refuse to send
  590.     commands which would interfere with its operation. Please refer to
  591.     the discussion of ESC key.
  592.  
  593.  
  594.  
  595.     ALT/F lets you inspect your function key setup:
  596.  
  597. ───────────────────────────────────────────────────────────────────────────────
  598.                      ╒════════ FUNCTION KEY SETUP ═════════╕
  599.                      │                                     │
  600.                      │ F01  Name & Qth                     │
  601.                      │ F02  Rig SHORT                      │
  602.                      │ F04  Rig LONG                       │
  603.                      │ F05  FEC CQ                         │
  604.                      │ F06  RYRYRY                         │
  605.                      │                                     │
  606.                      ╘═════════════════════════════════════╛
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  616.  
  617.  
  618. ───────────────────────────────────────────────────────────────────────────────
  619.  
  620.     You will get the function key title string, not the function key text
  621.     which can be much longer than the title, and even contain several
  622.     lines.
  623.  
  624.     The function key title strings as well as the function key text
  625.     strings are defined in the configuration file.
  626.  
  627.     This window also pops up should you press a function key which has
  628.     not been loaded with a string. Whenever you press a 'loaded' function
  629.     key, then the associated function key text is inserted in your output
  630.     to the PK-232.
  631.  
  632.  
  633.  
  634.     ALT/T in any mode pops up the PHS parameter setup window:
  635. ───────────────────────────────────────────────────────────────────────────────
  636.                                                   ╒═ PHS Parameters ══╕
  637.                                                   │                   │
  638.                                                   │ POLLDELAY      50 │
  639.                                                   │ BELL            1 │
  640.                                                   │ CBELL           1 │
  641.                                                   │ WORDWRAP       78 │
  642.                                                   │ MWINDOW         0 │
  643.                                                   │ FILTER          1 │
  644.                                                   │ YPKLEN        254 │
  645.                                                   │ MAXPFRAM       20 │
  646.                                                   │ MSTAMP          1 │
  647.                                                   │                   │
  648.                                                   │  <F1>  HELP       │
  649.                                                   │  <ESC> EXIT       │
  650.                                                   │  <F10> SET PARAM  │
  651.                                                   ╘═══════════════════╛
  652.  
  653.  
  654.  
  655.  M1234 ║ HF  ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  656.  
  657.   Enable the BELL (1/0)
  658. ───────────────────────────────────────────────────────────────────────────────
  659.  
  660.     The cursor is positioned at the input field of the first parameter
  661.     (BELL).  With any such setup window, you use  the up- and down-arrows
  662.     to select  the parameter which you want to change.
  663.  
  664.     As with the ALT/P parameter entry windows, PHS reads the actual
  665.     values, lets you apply changes, writes the parameters and then
  666.     re-reads them again. If you violated a given range for a parameter,
  667.     then no change is done, and this is immediately visible after PHS
  668.     reread the parameters.
  669.  
  670.     The PHS parameters are parameters for PHS rather than for the PK-232,
  671.     and allow you to:
  672.  
  673.     - change the polldelay of THS/PHS. To avoid an excessive system
  674.       load, THS/PHS does not poll the device continuosly but inserts
  675.       small delays between successive polls. You may somewhat finetune
  676.       Systemload vs THS/PHS performance here.
  677.  
  678.      - enable or disable if you want to hear 'bells' sent to you from a
  679.       connected station (you will never hear bells from monitored
  680.       stations) (BELL).  This parameter is effective in the packet modes
  681.       only.
  682.  
  683.     - enable or disable if you want to hear a bell (warble) when you get
  684.       a connect (CBELL). This parameter is effective in the packet modes
  685.       only.
  686.  
  687.     - set the packet frame length for binary transfers (YPKLEN). This
  688.       parameter is effective in the packet modes only.
  689.  
  690.     - set the column position of input word wrapping (WORDWRAP) - a zero
  691.       disables wrapping.
  692.  
  693.      - define the window which gets the monitored frames (MWINDOW).  By
  694.       default, this is window zero (because channel zero is the monitor
  695.       channel).  You can however route all monitored frames to another
  696.       channel window of your own choice. This parameter is effective in
  697.       the packet modes only.
  698.  
  699.      - filter out non-printable charcters (MFILTER). If this is enabled,
  700.       only BELL, HT, LF, VT, FF, CR and the characters with ASCII values
  701.       from 0x20 to 0x7E are displayed as is, the filtered charcter are
  702.       shown as a small solid rectangle.  If you use a national character
  703.       set, MFILTER should be disabled.
  704.  
  705.        The initial setting of MFILTER is defined in the configuration file's
  706.     PHS parameter definition line.
  707.  
  708.     YPKLEN needs an explanation. For binary sends, PHS switches the
  709.     PK-232 into  the transparent mode and the packet length  is defined
  710.     by YPKLEN. That is,  PHS will read YPKLEN slices from the file, add
  711.     the YAPP protocol layer and send it to the PK-232 (the PK-232
  712.     parameter PACLEN remain always preset to the maximum value of 256
  713.     bytes).
  714.  
  715.  
  716.  
  717.     ALT/K invokes the online editor of PHS. You are first asked for a
  718.     filename of a file which you want to edit. If the filename does not
  719.     exist, PHS asks you if you want to create the file. If you confirm,
  720.     you can start editing. In the example the filename "ROLF.MSG" was
  721.     given and because such a file did not exist, PHS was told to create
  722.     the file. Pressing F1 pops up a series of help windows for the
  723.     editor:
  724.  
  725. ───────────────────────────────────────────────────────────────────────────────
  726.    ╔═════════ File: "ROLF.MSG"  Line:005  Col:14  Free=7838  Insert   ═════════╗
  727.    ║Hallo Rolf,                                                                ║
  728.    ║                                                                           ║
  729.    ║i╒═══════════════════════ HELP - Use F2 to exit ═══════════════════════╕   ║
  730.    ║s│                                                                     │   ║
  731.    ║a│                                                                     │   ║
  732.    ║ │ ESC            Exit the editor. You get the option to save the      │   ║
  733.    ║ │                file to disk. If you don't, calling the editor       │   ║
  734.    ║ │                again will place you exactly where you left.         │   ║
  735.    ║ │ INSERT KEY     Toggles insert and overwrite modes                   │   ║
  736.    ╚═│ F8             Toggles whether carriage returns are symbolically    │═══╝
  737.      │                displayed in the edit window                         │
  738.      │ F9             Toggles editor display from 128 ASCII characters     │
  739.      │                to 256 IBM characters                                │
  740.      │ UP-ARROW       Moves cursor up a line                               │
  741.      │ DOWN-ARROW     Moves cursor down a line                             │
  742.      │ LEFT-ARROW     Moves cursor left a space                            │
  743.      │ RIGHT-ARROW    Moves cursor right a space                           │
  744.      │                                                            more...  │
  745.      ╘═════════════════════════════════════════════════════════════════════╛
  746.  
  747.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  748.  
  749.  
  750. ───────────────────────────────────────────────────────────────────────────────
  751.  
  752.     After you finished editing you will save the file to disk. This file
  753.     can then be sent by pressing the ALT/S key in any PK-232 mode. You
  754.     cannot send an unsaved file. At any time you can edit the saved file
  755.     again.
  756.  
  757.     You will not save the file to disk (but keep the text it the editors
  758.     buffer) if you temporarliy want to exit the editor and want to
  759.     continue editing later. If the editor is called with a previously
  760.     unsaved buffer, it pops up with the cursor positioned excatly where
  761.     you left before.
  762.  
  763.     When you edit, just realize that the Amtor and RTTY modes do not
  764.     support the full ascii character set.
  765.  
  766.     The editor buffer is limited to 8000 bytes which is sufficient for
  767.     message editing.
  768.  
  769.  
  770.  
  771.                        Printing and Logging
  772.                        ────────────────────
  773.  
  774.     There is no 'direct' print support for the OS/2 versions of THS/PHS
  775.     because the printers under OS/2 are normally spooled and not directly
  776.     accessible. It is recommended to log to a file and print that file
  777.     later.
  778.  
  779.     ALT/L toggles the logging to a file. Logging can be enabled
  780.     individually for each channel which will go to different files. When
  781.     you press ALT/L then a window pops up and asks you for the filename
  782.     of the file which will receive the logged data. You cannot specify
  783.     anything else but the filename, the extension is always "CAn" where
  784.     'n' is the channel number. The logfiles will be created in the
  785.     current OS/2 directory.
  786.  
  787.     You are offered a filename which is constructed from the current date
  788.     and time but you are free to select another filename. The filename
  789.     which is offered has the format "MDD_hhmm.CAn" where 'M' is the
  790.     hexadecimal number of the month (i.e.  1 to 9 for january to
  791.     september, and A, B and C for october, november and december). 'DD'
  792.     is the day of the month, 'hh' is the hour and 'mm' is the minute. A
  793.     logfile started October 23, at 12:34 for channel 3 would be given the
  794.     filename "A23_1234.CA3". Furthermore, if a subdirectory "LOG" exists
  795.     in the current directory, then the file is opened in the LOG
  796.     subdirectory, otherwise in the current directory.
  797.  
  798. ───────────────────────────────────────────────────────────────────────────────
  799.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │  L ║ 23-MAR 12:34:56
  800. ───────────────────────────────────────────────────────────────────────────────
  801.  
  802.     If logging is on for a channel, this is indicated by the logging-flag
  803.     "L" in column 61 of the statusline.
  804.  
  805.     When logging is already switched on for the channel and you press
  806.     ALT/L then you are asked if you want to stop logging.
  807.  
  808.     Everything which appears on the receive window of a channel will go
  809.     to the logfile if logging is enabled for that channel.
  810.  
  811.  
  812.  
  813.     ALT/S permits to send any file containing Ascii text. You are asked
  814.     for the filename of the file to be sent. This filename is preset to
  815.     the filename you specified for editing (if you did edit before) but
  816.     can be overwritten.
  817.  
  818. ───────────────────────────────────────────────────────────────────────────────
  819. KANALZUTEILUNG
  820. *** Bulletin-ID: 158902HB9PD ***
  821.      ╒═══════════════════════ ASCII FILE SEND ════════════════════════╕
  822. de HB│                                                                │
  823.      │ Filename: PRIGCHAN.TXT                                         │
  824. Als B│ Sending line 22 of 37 - ALT/A to abort                         │
  825. "USER│                                                                │
  826. ausre╘════════════════════════════════════════════════════════════════╛
  827. abgerufen.
  828. Interessant dabei duerfte neben dem Call der USER auch sein auf
  829. welcher Frequenz der jeweilige Benutzer die Box erreicht hat.
  830.  
  831. Die Kanalzuteilung ist wie folgt organisiert:
  832.  
  833. Total 18 Kanaele
  834. ****************
  835.  
  836. Kanal 1-4      Direktzugang auf 70cm Freqq. 430.675
  837.  
  838. Kanal 5-9
  839.                Store und Forward mit HB9AJ, HB9XC und DB0CZ
  840.  M1234 ║ VHF ║ UA:05 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-MAR 12:34:56
  841.  
  842.  
  843. ───────────────────────────────────────────────────────────────────────────────
  844.  
  845.     Note that the line number which is sent refers to the line which is
  846.     currently sent to the PK-232, not the line which is actually
  847.     transmitted by the PK-232.
  848.  
  849.     In the packet modes, the text scrolls behind the ASCII FILE SEND
  850.     window when it is sent. In the other modes, the text scrolls in the
  851.     transmit window, and in the receive window the echo will appear from
  852.     the PK-232 when the text is transmitted.
  853.  
  854.  
  855.  
  856.     ESC pops up the direct command input window:
  857.  
  858. ───────────────────────────────────────────────────────────────────────────────
  859.  
  860.  
  861.  
  862.  
  863. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  864. │ CMD> MYSELCAL               ╒═══ RESPONSE ════╕                              │
  865. ╘═════════════════════════════│ MYSELCAL: HCVV  │══════════════════════════════╛
  866.                               ╘═════════════════╛
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  AMTOR LISTEN  ║ RECEIVE  │  Phasing      ║              │    ║ 23-MAR 12:34:56
  875.  
  876. ───────────────────────────────────────────────────────────────────────────────
  877.  
  878.     You use the 'normal' command mnemonics of the dialog mode of the
  879.     PK-232. PHS translates this into hostmode commands, and also
  880.     translates the host-mode response back to the dialoge mode mnemonics.
  881.  
  882.     For THS, you must use the mnemonics of the normal TAPR firmware -
  883.     this is translated into the (more cryptic) WA8DED mnemonics by THS
  884.     and vs.
  885.  
  886.     In the CMD entry window you can inspect ALL parameters and modify
  887.     most of them.  Writing of some parameters is disabled however because
  888.     a direct execution would interfere with the operation of PHS. In
  889.     either case you will get a message like one of the following:
  890.  
  891. ───────────────────────────────────────────────────────────────────────────────
  892.  
  893. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  894. │ CMD> PA   ╒════════════════════ INFORMATION ════════════════════╕            │
  895. ╘═══════════│ PACKET: disabled - use ALT/M to switch device modes │════════════╛
  896.             ╘═════════════════════════════════════════════════════╛
  897.  
  898. ───────────────────────────────────────────────────────────────────────────────
  899.  
  900. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  901. │ CMD> MF╒═══════════════════════ INFORMATION ═══════════════════════╕         │
  902. ╘════════│ MFILTER: disabled - this parameter must remain unchanged  │═════════╛
  903.          ╘═══════════════════════════════════════════════════════════╛
  904.  
  905. ───────────────────────────────────────────────────────────────────────────────
  906.  
  907.     ALT/M in any mode pops up the device mode select screen:
  908.  
  909. ───────────────────────────────────────────────────────────────────────────────
  910.  
  911.  
  912.  
  913.                               ╒══ DEVICE MODE ═══╕
  914.                               │                  │
  915.                               │   Packet (V)HF   │
  916.                               │   Packet (H)F    │
  917.                               │  Amtor (L)isten  │
  918.                               │  Amtor (S)tandby │
  919.                               │   (R)TTY Baudot  │
  920.                               │     (A)SCII      │
  921.                               │     (M)orse      │
  922.                               │     S(I)gnal     │
  923.                               │  Pa(C)tor Listen │
  924.                               │ (P)actor Standby │
  925.                               │                  │
  926.                               ╘══════════════════╛
  927.  
  928.  
  929.  
  930.  M1234 ║ HF  ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  931.  
  932.  
  933. ───────────────────────────────────────────────────────────────────────────────
  934.  
  935.     To select the PK-232 mode, you can either press the marked character,
  936.     or move the scroll bar up and down and then press ENTER. The bar is
  937.     not visible in this printout.
  938.  
  939.     The two different modes for packet just use different values for some
  940.     PK-232 parameters.
  941.  
  942.     Packet VHF and HF use the parameter values recommended by AEA.
  943.  
  944.     The different packet modes are indicated in the statusline. You will
  945.     see "VHF" in place of "HF" if the PK-232 is in packet-VHF.
  946.  
  947.     The FAX and NAVTEX modes are not supported.
  948.  
  949.     The remainder of the general keys will be discussed after the
  950.     discussion of the individual modes.
  951.  
  952.  
  953.  
  954.                                 PACKET MODES
  955.                                 ────────────
  956.  
  957.     There is one difference between the packet-modes and the other modes:
  958.     in packet you are offered one monitor channel window and four
  959.     connectable channel windows (for all other modes there is just one
  960.     receive window). The channels numbers are from zero to four, but
  961.     channel zero is marked with an "M" to remind you that this is the
  962.     monitor channel. You use the left-arrow and right-arrow keys to
  963.     switch the channels. When you switch to a new channel, the full
  964.     (upper) receive window is completely replaced by the new channel
  965.     window. The status line changes also, reflecting the status of
  966.     currently selected window.
  967.  
  968.     The channel indicator is on the leftmost side of the status line. The
  969.     current channel is indicated by a reverse letter, that is, one of the
  970.     letters of the M1234 string - which is normally (like the rest of the
  971.     statusline) dark on cyan - is cyan on black. Also, if you selected
  972.     one channel - this is called the active channel and the active
  973.     (receive) window - and ANOTHER channel gets input, then the indicator
  974.     of that channel changes to white on cyan. Once you selected that
  975.     window for inspection, the indicator returns to its normal color.
  976.  
  977.     The monitored channel gets all monitored packets and you cannot
  978.     connect on this channel. The statusline for the monitored channel is:
  979.  
  980. ───────────────────────────────────────────────────────────────────────────────
  981.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-MAR 12:34:56
  982. ───────────────────────────────────────────────────────────────────────────────
  983.  
  984.     However you can redirect the monitored input to one of the
  985.     connectable channels if you want to see the monitoring there. Please
  986.     refer to the MWINDOW command in the ALT/T window.
  987.  
  988.     For the channels 1 to 4 the status line is like this:
  989.  
  990. ───────────────────────────────────────────────────────────────────────────────
  991.  M1234 ║ VHF ║ UA:03 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-MAR 12:34:56
  992. ───────────────────────────────────────────────────────────────────────────────
  993.  
  994.     The number after the "UA:" is the number of unacknowledged frames,
  995.     RTY displays the number of retries so far. The next field is the link
  996.     state.
  997.  
  998.     Pressing the INS key toggles the status line to the other display
  999.     format:
  1000.  
  1001. ───────────────────────────────────────────────────────────────────────────────
  1002.  M1234 ║ VHF ║ HB9PD via HB9PD-7                         │    ║ 23-MAR 12:34:56
  1003. ───────────────────────────────────────────────────────────────────────────────
  1004.  
  1005.     The UA/RTY and linkstate field is replaced by the connectee. If you
  1006.     use several digipeaters and the string is gets too long, the
  1007.     connectee string is truncated on the right hand side.
  1008.  
  1009. --------------------------- NOTE ON THS ---------------------------------------
  1010.  
  1011.     The statusline for THS is like:
  1012.  
  1013. ───────────────────────────────────────────────────────────────────────────────
  1014.  M1234 ║ NS:07 UA:03 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-MAR 12:34:56
  1015. ───────────────────────────────────────────────────────────────────────────────
  1016.  
  1017.     Where NS indicates the number of frames which have been already moved
  1018.     to the TNC but have not yet been sent.
  1019.  
  1020.  
  1021.     ALT/P in packet mode pops up the packet mode PK-232 parameter setup
  1022.     window:
  1023.  
  1024. ───────────────────────────────────────────────────────────────────────────────
  1025.           ╒════════════════════ PK-232 Parameters ════════════════════╕
  1026.           │                                                           │
  1027.           │ ACKPRIOR        Y   HID             N   RESPTIME        0 │
  1028.           │ AUDELAY         0   LITE            N   RETRY          10 │
  1029.           │ AX25L2V2        Y   MAXFRAME        4   SLOTTIME       30 │
  1030.           │ AXDELAY         0   MCON            6   SQUELCH         N │
  1031.           │ AXHANG          0   MID             0   TRIES           0 │
  1032.           │ BEACON        E 0   MONITOR         6   TXDELAY        40 │
  1033.           │ CHECK          25   MRPT            Y   USERS           4 │
  1034.           │ CMSG            N   MSTAMP          N   WHYNOT          N │
  1035.           │ CODE            2   MYALIAS    BIENNE   XMITOK          Y │
  1036.           │ CONPERM         N   MYCALL     HB9CVV                     │
  1037.           │ DWAIT          16   PASSALL         N   <F1>  HELP        │
  1038.           │ FRACK           8   PERSIST        84   <ESC> EXIT        │
  1039.           │ FRICK           0   PPERSIST        Y   <F10> SET PARAM   │
  1040.           │ FULLDUP         N   RELINK          N                     │
  1041.           │                                                           │
  1042.           ╘═══════════════════════════════════════════════════════════╛
  1043.  
  1044.  
  1045.  
  1046.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-MAR 12:34:56
  1047.  
  1048.   Audio delay in 10mS (range 0-120)
  1049. ───────────────────────────────────────────────────────────────────────────────
  1050.  
  1051.     PHS/THS always reads the parameters from the PK-232/TNC, so you
  1052.     always get the actual PK-232 or TNC-1/2 parameters. You can now move
  1053.     the cursor to a command and change the parameter.  To apply the
  1054.     changes, press F10. PHS then writes the parameters to the PK-232 and
  1055.     re-reads them again. If a parameter which you have changed again gets
  1056.     the old value, then you have violated a range check and the PK-232
  1057.     refused to accept your value. The process of reading, writing, and
  1058.     re-reading is indicated in the window. It also takes a few seconds,
  1059.     even when the communiation line to the PK-232 is operated at 9600
  1060.     bauds.
  1061.  
  1062.     You will see all parameter which are valid for the packet mode, and
  1063.     which you may change. You may miss some packet mode commands here -
  1064.     but the parameters of such commands must remain unchanged at preset
  1065.     values for a proper operation of PHS.
  1066.  
  1067.     There are some commands like MRPT and PASSALL which should be changed
  1068.     only if neccessary, because there is still a possible interaction.
  1069.     For example, quite obviously, if you surpress the indication of
  1070.     digipeaters in monitored frames then the HEARD-List of PHS will not
  1071.     contain only incomplete information. Also, if PASSALL is YES, you can
  1072.     get 'clobbered' callsigns in the heard-list.
  1073.  
  1074.     For some commands (BEACON, MCON and MONITOR) you will get a secondary
  1075.     selection window which offers you discrete choices.
  1076.  
  1077.  
  1078.  
  1079.     A typical screen from the monitored channel is like this:
  1080.  
  1081. ───────────────────────────────────────────────────────────────────────────────
  1082. HB9X-7*>HB9X-9 [I;3,3]:
  1083. NON - Bid 21A90BHB9X deja recu
  1084. 8>
  1085. HB9X-6*>4U1ITU-8 (RR;3)
  1086. HB9X-6*>4U1ITU-8 [I;3,2]:
  1087. SB ALL    < OH1HS  @ EU $787_ON4HU
  1088. HB9X-7*>HB9X-9 (RR;4)
  1089. HB9X-6*>4U1ITU-8 (RR,F;3)
  1090. HB9X-7*>HB9CED [I;3,2]:
  1091. MOL:HB9X-7} Invalid command (CONNECT CQ IDENT NODES PARMS ROUTES USERS)
  1092. HB9X-7*>HB9DIG>HB9DIG-7 [RR,P;6]
  1093. HB9X-6*>4U1ITU-8 (RR,F;3)
  1094. HB9DIG-7>HB9DIG*>HB9X-7 [I;1,6]CF:
  1095. ■NET/ROM frame: orgin node DB0FRG-2 to dst node HB9X-7, ttl: 24
  1096. INFO ACK: ckt 0/238, rxseq 2
  1097. HB9X-7*>HB9X-9 [I;4,4]:
  1098. NON - Bid 21A90BHB9X deja recu
  1099. 8>
  1100. HB9X-7*>HB9CED [RR,P;3]
  1101. HB9X-7*>HB9CED (RR,F;3)
  1102. HB9X-6*>4U1ITU-8 (RR;4)
  1103.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-MAR 12:34:56
  1104.  
  1105.  
  1106. ───────────────────────────────────────────────────────────────────────────────
  1107.  
  1108.     If something is scrolled off-screen, press ALT/R or Up-arrow to
  1109.     review it again.  Reviewing is possible individually for all channels
  1110.     on packet (and for the single channel of the other modes). The lower
  1111.     (transmit) window will be superseded by:
  1112.  
  1113. ────────────────────────────────── .... ───────────────────────────────────────
  1114.              Cursor on line   0 of 200
  1115.              REWIEW - Use:   PgUp PgDn, ESC to exit
  1116.                ALT/L - Snapshot to file
  1117. ───────────────────────────────────────────────────────────────────────────────
  1118.  
  1119.     Use the indicated keys for moving, and ESC to leave the reviewing.
  1120.     The number of lines which you have for reviewing depends on
  1121.     parameters in the configuration file. The minimum is 50, the maximum
  1122.     is about 500. These values can be set individually for each channel.
  1123.  
  1124.     Whenever you start reviewing, PHS makes a copy the current active
  1125.     receive window to the review buffer, and then covers the upper 85% of
  1126.     the receive window to present the review buffer. The "Cursor on line"
  1127.     gives you an indication where you are inside the review buffer.
  1128.     During review, receiving to the (mostly covered) receive window
  1129.     continues.
  1130.  
  1131.     ALT/L lets you snapshot the review buffer to a file in the current
  1132.     OS/2 directory. The filename is generated from the date and time and
  1133.     the extension is always "SNP". For the 23 October at 12:34:56 the
  1134.     generated filename will be "A23_1234.SNP" (see "Logging and Printing"
  1135.     for a discussion of the generated filenames). Furthermore, if a
  1136.     subdirectory "LOG" exists in the current directory, then the file is
  1137.     opened in the LOG subdirectory, otherwise it is opened in the current
  1138.     directory.
  1139.  
  1140.  
  1141.  
  1142.     You press ALT/H to get the heard list formatted and sorted last heard
  1143.     first:
  1144.  
  1145. ───────────────────────────────────────────────────────────────────────────────
  1146. BBS H╒═══════ HEARD LIST (entries: 10) - XXXX - <Enter> to connect ════════╕
  1147.      │  1. 23-MAR 12:34:56  HB9X-7                                         │
  1148. Enreg│  2. 23-MAR 12:34:56  HB9CED-15                                      │
  1149. Enreg│  3. 23-MAR 12:34:56  HB9DIG-7 via HB9DIG                            │
  1150.      │  4. 23-MAR 12:34:56  HB9AC-8 via HB9DIG HB9AC                       │
  1151. Pas d│  5. 23-MAR 12:34:56  DG7KAR-8 via HB9DIG DB0DQ DB0GE-2              │
  1152. HB9CE│  6. 23-MAR 12:34:56  HB9X-6                                         │
  1153. DG7KA│  7. 23-MAR 12:34:56  HB9X-9                                         │
  1154. HB9AC│  8. 23-MAR 12:34:56  DG7KAR-7                                       │
  1155. HB9CE│  9. 23-MAR 12:34:56  HB9X-14                                        │
  1156. HB9X-│ 10. 23-MAR 12:34:56  DB1EC-15                                       │
  1157. HB9X-╘═════════════════════════════════════════════════════════════════════╛
  1158. HB9DIG-7>HB9DIG*>HB9X-7 (RR,F;1)
  1159. HB9X-7*>HB9CED [I;1,2]:
  1160. tion pour l'instant.
  1161.  
  1162. (H)elp (C)heck (L)ist (R)ead (S)end (E)rase (D)ir (U)sage (SP)eak (Q)uit
  1163. HB9CED de HB9X>
  1164. HB9CED-15*>HB9X [I;2,0]:
  1165. C HB9N-7
  1166. HB9X-7*>HB9CED (RR;2)
  1167.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-MAR 12:34:56
  1168.  
  1169.  
  1170. ───────────────────────────────────────────────────────────────────────────────
  1171.  
  1172.     If you select the raw heard list, you get the original frames
  1173.     unformatted but still sorted by time:
  1174.  
  1175. ───────────────────────────────────────────────────────────────────────────────
  1176. Enreg╒═══════ HEARD LIST (entries: 10) - XXXX - <Enter> to connect ════════╕
  1177. Enreg│  1. 23-MAR 12:34:56  HB9CED-15*>HB9X (RR;3)                         │
  1178.      │  2. 23-MAR 12:34:56  HB9X-7*>HB9CED (RR,F;2)                        │
  1179. Pas d│  3. 23-MAR 12:34:56  HB9DIG-7>HB9DIG*>HB9X-7 (RR,F;1)               │
  1180. HB9CE│  4. 23-MAR 12:34:56  HB9AC-8>HB9AC>HB9DIG*>HB9X-9 [C,P]             │
  1181. DG7KA│  5. 23-MAR 12:34:56  DG7KAR-8>DB0GE-2>DB0DQ>HB9DIG*>HB9X-7 (RR,F;4) │
  1182. HB9AC│  6. 23-MAR 12:34:56  HB9X-6*>4U1ITU-8 (DM,F)                        │
  1183. HB9CE│  7. 23-MAR 12:34:56  HB9X-9*>HB9X-7 (DM,F)                          │
  1184. HB9X-│  8. 23-MAR 12:34:56  DG7KAR-7*>4U1ITU-8 (RR;4)                      │
  1185. HB9X-│  9. 23-MAR 12:34:56  HB9X-14*>HB9DIG>HB9AC>HB9AC-8 [I;2,1]:         │
  1186. HB9DI│ 10. 23-MAR 12:34:56  DB1EC-15*>4U1ITU-8 [D,P]                       │
  1187. HB9X-╘═════════════════════════════════════════════════════════════════════╛
  1188. tion pour l'instant.
  1189. ────────────────────────────────── .... ───────────────────────────────────────
  1190.  
  1191.     The heard list will contain a maximum of 50 different stations. If
  1192.     more than 50 stations have been heard, the oldest call is superseded.
  1193.     You use the arrow keys to scroll within the heard list. A scroll bar,
  1194.     which again is not visible here is moving - you can position the bar
  1195.     on an entry on the heard list and simply press the ENTER key to try a
  1196.     connect. You must first select an unconnected channel, pop up the
  1197.     heard-list by ALT/H, select the entry and press ENTER.
  1198.  
  1199.     The arrows are visible in place of the "XXXX" which you see here in
  1200.     the heard list title.  These little arrows cannot be used in this
  1201.     printout and had to be substituted.
  1202.  
  1203.  
  1204.     ALT/C pops up the Connect window, this has the same look-and-feel
  1205.     like the UNPROTO window which we discussed before. To summarize, if
  1206.     you want to initialize a connection, you have three choices:
  1207.  
  1208.              - the Connect-window by ALT/C
  1209.              - by a selection of the heard-list
  1210.              - by an entry in the command directory (ALT/W), provided you
  1211.           have preset connect commands there.
  1212.  
  1213.     ALT/D is used to initialize a disconnect.
  1214.  
  1215.     If someone is connecting you, PHS will give a sound (warble). For
  1216.     incoming connects the PK-232 selects the lowest unconnected channel,
  1217.     which might not necessarily be the channel which you have currently
  1218.     selected for display.  You will still realize such a connect because
  1219.     of the warble, and because the channels indicator is highlighted.
  1220.  
  1221.     Any text which you type will appear in the lower transmit window. If
  1222.     word-wrapping is on (which is the default, see ALT/T), your text will
  1223.     wrap. The input text is sent to the PK-232 when you press the ENTER
  1224.     key. It is then removed from the transmit window and inserted into
  1225.     the receive window.  Additionally the text is highlighted in the
  1226.     receive window, so you can easily distinguish between your text and
  1227.     the received text.
  1228.  
  1229.     Note that the transmit buffer of PHS is 250 characters. You will get
  1230.     the warning "At end of TX-buffer" if you reached the end of the
  1231.     buffer. You will get the warning "At beginning of TX-buffer" when you
  1232.     erase characters and no more characters are available for deletion.
  1233.  
  1234.                         BINARY FILE TRANSFERS
  1235.                         ─────────────────────
  1236.  
  1237.     The next and last chapters for the Packet-modes show how binary
  1238.     transfers are done. PHS implements the YAPP protocol as defined by
  1239.     Jeff Jacobson, WA7MBL.  Care should be exercised when employing
  1240.     binary transfers because upon entry of the yapp transfer mode, PHS
  1241.     will change the PK-232 parameters to obtain maximum throughput. These
  1242.     parameters are reset to the previous values when you leave the yapp
  1243.     transfer mode. To keep friends, yapp-transfers should not be done on
  1244.     qso channels - use a free channel. You also CANNOT change channels
  1245.     during a binary transfer, you will have to finish or abort the
  1246.     transfer first.  Consequently you can invoke a binary transfer on ONE
  1247.     channel only. Again, this is optimized for throughput and is intended
  1248.     to provide fast transfers.
  1249.  
  1250.     Yapp uploading (sending of a binary file) is invoked with the PgUp
  1251.     key, downloading (receiving) with the PgDn key. PHS will ask you for
  1252.     a filename first, and then enter the yapp transfer mode. Note that
  1253.     when you are receiving, you will also have to specify the filename of
  1254.     a file which will get the data.
  1255.  
  1256.     Note: YAPP transfers have not been extensively tested in the OS/2
  1257.           versions.
  1258.  
  1259.  
  1260.     When sending a binary transfer, you get a window like this:
  1261.  
  1262. ───────────────────────────────────────────────────────────────────────────────
  1263.                     ╒═════ Uploading (YAPP) - ALT/A: Cancel - ALT/K: Kill ═════╕
  1264. 23-MAR-89  12:29:32 │                                                          │
  1265.                     │    FILE: PHS.EXE                                         │
  1266.                     │    Size:  198583                                         │
  1267.                     │    Date: 23-MAR-89 20:41                                 │
  1268.                     │                                                          │
  1269.                     │  Header:  PHS.EXE  198583 bytes, 23-MAR-89 20:41         │
  1270.                     │   Bytes:    11938 read,   10414 sent                     │
  1271.                     │    Rate:       95 bytes/sec, time to go:  33:00          │
  1272.                     │                                                          │
  1273.                     │   STATE:  Sending DATA                                   │
  1274.                     │                                                          │
  1275.                     │   TNC buffer full, waiting.                              │
  1276.                     │                                                          │
  1277.                     ╘══════════════════════════════════════════════════════════╛
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  M1234 ║ VHF ║ UA:06 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-MAR 12:34:56
  1283.  
  1284.  
  1285. ───────────────────────────────────────────────────────────────────────────────
  1286.  
  1287.     The bytes read indicate the number of bytes read from the file, the
  1288.     bytes sent is the number of acknowledged bytes. The message "TNC
  1289.     buffer full, waiting." indicates that the PK-232s buffer are full and
  1290.     that PHS is waiting for the PK-232 to become ready for another slice
  1291.     of data.
  1292.  
  1293.     Unfortunately the PK-232 does not buffer more than MAXF frames, which
  1294.     reduces the maximum obtainable troughput to below 100 bytes per
  1295.     second. With other devices like TNC-2 or the PC*Packet Adapter it is
  1296.     possible to reach up to 125 bytes per second. Yes, the link is 1200
  1297.     bauds, but AX-25 is a syncronous protocol, so a single data byte is
  1298.     not framed with start and stop bits as on asynchronous RS-232 links.
  1299.     The theoretical maximum is 1200/8 bytes per second, and the AX-25
  1300.     protocol overhead reduces this number then by at least 15%.
  1301.  
  1302.     If you want to abort a transfer, you can use ALT/A to cancel it,
  1303.     which uses the cancel mechanism of the yapp protocol. If you got a
  1304.     bad link however you will have a TNC full with untransmitted frames
  1305.     and the frame with the cancel request queued behind. Unfortunately
  1306.     the only way to flush the untransmitted data in the PK-232 is a
  1307.     disconnect.
  1308.  
  1309.     This is why ALT/K has been introduced: ALT/K will kill the transfer
  1310.     by disconnecting the link and then will re-connect. All of this is
  1311.     accompanied by messages on the screen.
  1312.  
  1313.     The YAPP-download window is similar to the upload window. Note
  1314.     however that the number for the troughput (bytes/sec) will always
  1315.     differ slightly between receiver and sender - there are always some
  1316.     data packets on the air.
  1317.  
  1318.  
  1319.  
  1320.                                 AMTOR MODES
  1321.                                 ───────────
  1322.  
  1323.     ALT/Z in the amtor modes pops up the amtor-modes help screen:
  1324.  
  1325. ───────────────────────────────────────────────────────────────────────────────
  1326.  
  1327.   ╒═══════════════════════════════ AMTOR MODES ═══════════════════════════════╕
  1328.   │                                     ║                                     │
  1329.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1330.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View OS/2 directory         │
  1331.   │ ALT/W   Command string directory    ║ ALT/F   View function-key setup     │
  1332.   │ ALT/L   Logging (capture) on/off    ║ ALT/R   or  Review (scrollback)    │
  1333.   │ ALT/S   Send an ASCII file          ║ ALT/K   Call Editor                 │
  1334.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1335.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1336.   │ ALT/M   Switch TNC modes            ║ ESC     Direct command entry        │
  1337.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1338.   │ ALT-C   Start ARQ call              ║ GRAY +  Start FEC transmit          │
  1339.   │ ALT-Y   Start SELFEC call           ║ GRAY -  FEC: Receive - immediate    │
  1340.   │ INS     LISTEN: Resynchronize       ║         ARQ: Break link - immediate │
  1341.   │         ARQ: Force changeover       ║ GRAY *  Clear PK-232 tx buffer      │
  1342.   │ DEL     Force LETTERS case          ║        Toggle LISTEN <> STANDBY    │
  1343.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1344.   │ CTRL-D  FEC: Switch to receive      ║ CTRL-O  Send LETTERS character      │
  1345.   │         ARQ: Break link             ║ CTRL-N  Send FIGURES character      │
  1346.   │ CTRL-F  Like CTRL-D, add CW-id      ║ CTRL-B  Send "urcall de mycall"     │
  1347.   │ CTRL-T  Send date+time              ║ END     Send "BTU <CTRL-B> +?"      │
  1348.  A│                                     ║                                     │
  1349.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1350.  
  1351.  
  1352. ───────────────────────────────────────────────────────────────────────────────
  1353.  
  1354.     The single 'A' visible on the left side is from the covered status
  1355.     line. If you had setup another screen size before calling PHS (e.g.
  1356.     80*43), then the statusline would not be covered by the window and
  1357.     would be visble.
  1358.  
  1359.     The status line in the Amtor modes is like:
  1360.  
  1361. ───────────────────────────────────────────────────────────────────────────────
  1362.  AMTOR LISTEN  ║ RECEIVE  │  Phasing      ║              │    ║ 23-MAR 12:34:56
  1363. ───────────────────────────────────────────────────────────────────────────────
  1364.  
  1365.     where the second field will indicate either "RECEIVE" or "TRANSMIT",
  1366.     and the first field will show "AMTOR LISTEN", "AMTOR STANDBY" "AMTOR
  1367.     QSO", "FEC" or "SELFEC". The third field indicates the current PK-232
  1368.     status and closely follows the LED indicators of the PK-232. The
  1369.     forth field is always empty. The fifth field will contains the "L"
  1370.     indicator, when logging is on.
  1371.  
  1372.     Opposed to the packet mode, where your text is sent to the PK-232
  1373.     when you press the ENTER key, in non-packet modes your text is sent
  1374.     to the PK-232 on a word-by-word basis, and is buffered in the PK-232.
  1375.     The text is not cleared in the lower transmit window but instead it
  1376.     will scroll there. It is echoed in the upper receive window by the
  1377.     PK-232 whenever it is sent out (echo-as-sent). The wordwise operation
  1378.     allows you to correct only the current word. It is not possible to
  1379.     correct text which has already been sent to the PK-232. For an
  1380.     indication about what has already been sent to the PK-232, the
  1381.     already-sent text is highlighted. So if you typed in:
  1382.  
  1383.             Did you have to apply any modificati
  1384.  
  1385.     and the cursor is positioned after the 'i', then all previous lines,
  1386.     and this line up to and including the word 'any' is highlighted, but
  1387.     'modificati' is not, because it has not yet been sent.
  1388.  
  1389.     You start a FEC transmission with the GRAY PLUS key (on the keypad).
  1390.     Normally you will not stop the transmission with the GRAY MINUS key
  1391.     because the PK-232 will then immediately switch to receive,
  1392.     regardless of still untransmitted text.  If you switch to receive
  1393.     with untransmitted text, you will get a warning message from PHS
  1394.     ("transmit data remaining"). This data will be sent the next time
  1395.     when you switch to transmit. However you have the option to flush the
  1396.     data by clearing the PK-232's transmit buffer with the GRAY-* key.
  1397.  
  1398.     Anytime you can insert a CTRL/D or CTRL/F into the text which you
  1399.     input. The PK-232 will switch to receive whenever it detects such a
  1400.     character (refer to the PK-232 manual) in the transmit data stream.
  1401.     Just a note: when you insert a CTRL/D followed by a carriage return
  1402.     (Enter-key), then you will get the transmit-data-remaining warning,
  1403.     because after switching to receive by the CTRL/D, the carriage return
  1404.     is still untransmitted.
  1405.  
  1406.     To start a Amtor QSO, press ALT/C and you will get a small window
  1407.     which lets you enter the other stations selcal. For a SELFEC
  1408.     transmission, press ALT/Y.
  1409.  
  1410.     You may use ALT/B to pop up a window which lets you enter the remote
  1411.     stations callsign, and once you did, whenever you insert a CTRL/B
  1412.     into the transmit text, it is replaced by PHS with the string "
  1413.     <remote-callsign> DE <my-callsign> ".  My-callsign is from line one
  1414.     in the configuration file (a possible packet-SSID is removed).
  1415.  
  1416.     For convenience, in ARQ, the END key inserts the Amtor-changeover
  1417.     signal "+?" into the transmit text.
  1418.  
  1419.     If you are in Amtor-Listen mode and you have difficulties to monitor
  1420.     an Amtor-qso use the INS key to force a resynchronisation. If you are
  1421.     in an ARQ qso, the INS key forces a changeover.
  1422.  
  1423.  
  1424.     ALT/P in the amtor modes pops up the amtor-modes PK-232 parameter
  1425.     setup window:
  1426.  
  1427. ───────────────────────────────────────────────────────────────────────────────
  1428.  
  1429.                                    ╒══════════ PK-232 Parameters ══════════╕
  1430.                                    │                                       │
  1431.                                    │ ADELAY          4   SRXALL          Y │
  1432.                                    │ ARQTMO         60   TXREV           Y │
  1433.                                    │ ARQTOL          3   WIDESHFT        N │
  1434.                                    │ CODE            2   WRU             N │
  1435.                                    │ MYALTCAL     HCVV                     │
  1436.                                    │ MYIDENT   KBPCVVV   <F1>  HELP        │
  1437.                                    │ MYSELCAL     HCVV   <ESC> EXIT        │
  1438.                                    │ RFEC            Y   <F10> SET PARAM   │
  1439.                                    │ RXREV           N                     │
  1440.                                    │                                       │
  1441.                                    ╘═══════════════════════════════════════╛
  1442.  
  1443.  AMTOR LISTEN  ║ RECEIVE  │  Phasing      ║              │    ║ 23-MAR 12:34:56
  1444.  
  1445.   ARQ transmit delay in 10mS (range 1-9)
  1446. ───────────────────────────────────────────────────────────────────────────────
  1447.  
  1448.  
  1449.                                 PACTOR MODES
  1450.                                 ────────────
  1451.  
  1452.     ALT/Z in the pactor modes pops up the pactor-modes help screen:
  1453.  
  1454. ───────────────────────────────────────────────────────────────────────────────
  1455.  
  1456.  ╒══════════════════════════════ PACTOR MODES ═══════════════════════════════╕
  1457.  │                                     ║                                     │
  1458.  │ ALT-P   PK-232 param setup menu     ║ ALT-I   PK-232 textparam setup menu │
  1459.  │ ALT-T   PHS parameter setup menu    ║ ALT-V   View OS/2 directory         │
  1460.  │ ALT-W   Command string directory    ║ ALT-F   View function-key setup     │
  1461.  │ ALT-L   Logging (capture) on/off    ║ ALT-R   or  Review (scrollback)    │
  1462.  │ ALT-S   Send an ASCII file          ║ ALT-K   Call Editor                 │
  1463.  │ ALT-B   Enter urcall (remote call)  ║ CTRL-U  Erase TX-window             │
  1464.  │ ALT-X   Exit PHS                    ║ CTRL-X  Erase RX-window             │
  1465.  │ ALT-M   Switch PK-232 modes         ║ ESC     Direct command entry        │
  1466.  │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1467.  │ ALT-C   PACTOR connect menu         ║ ALT-D   CONNECT: Break link immedia │
  1468.  │ GRAY *  Clear PK-232 tx buffer      ║ GRAY +  Start UNPROTO transmit      │
  1469.  │ GRAY -  UNPROTO: Receive, immediate ║ INS     LISTEN: Resynchronize       │
  1470.  │         CONNECT: Break link immedia ║         CONNECT: Force changeover   │
  1471.  │ DEL     CONNECT: Break link         ║        Toggle LISTEN <-> STANDBY   │
  1472.  │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1473.  │ CTRL-D  UNPROTO: Switch to receive  ║ CTRL-Y  CONNECT: Changeover         │
  1474.  │         CONNECT: Break link         ║ CTRL-F  Like CTRL-D, add CW-id      │
  1475.  │ CTRL-B  Send "urcall de mycall"     ║ CTRL-T  Send date+time              │
  1476.  │ END     Send "BTU <CTRL-B><CTRL-Y>" ║                                     │
  1477. P│                                     ║                                     │
  1478.  ╘═══════════════════════════════════════════════════════════════════════════╛
  1479.  
  1480.     The single 'P' visible on the left side is from the covered status
  1481.     line. If you had setup another screen size before calling PHS (e.g.
  1482.     80*43), then the statusline would not be covered by the window and
  1483.     would be visble.
  1484.  
  1485.     The status line in the Pactor modes is like:
  1486.  
  1487. ───────────────────────────────────────────────────────────────────────────────
  1488.  PACTOR LISTEN ║ RECEIVE  │  Phasing      ║              │    ║ 23-MAR 12:34:56
  1489. ───────────────────────────────────────────────────────────────────────────────
  1490.  
  1491.     where the second field will indicate either "RECEIVE" or "TRANSMIT",
  1492.     and the first field will show "PACTOR LISTEN", "PACTOR STANDBY",
  1493.     PACTOR CONNECT" or "PACTOR UNPROTO". The third field indicates the
  1494.     current PK-232 status and closely follows the LED indicators of the
  1495.     PK-232. The forth field is always empty. The fifth field will
  1496.     contains the "L" indicator, when logging is on.
  1497.  
  1498.     Opposed to the packet mode, where your text is sent to the PK-232
  1499.     when you press the ENTER key, in non-packet modes your text is sent
  1500.     to the PK-232 on a word-by-word basis, and is buffered in the PK-232.
  1501.     The text is not cleared in the lower transmit window but instead it
  1502.     will scroll there. It is echoed in the upper receive window by the
  1503.     PK-232 whenever it is sent out (echo-as-sent). The wordwise operation
  1504.     allows you to correct only the current word. It is not possible to
  1505.     correct text which has already been sent to the PK-232. For an
  1506.     indication about what has already been sent to the PK-232, the
  1507.     already-sent text is highlighted. So if you typed in:
  1508.  
  1509.             Did you have to apply any modificati
  1510.  
  1511.     and the cursor is positioned after the 'i', then all previous lines,
  1512.     and this line up to and including the word 'any' is highlighted, but
  1513.     'modificati' is not, because it has not yet been sent.
  1514.  
  1515.     You start an UNPROTO transmission with the GRAY PLUS key (on the
  1516.     keypad).  Normally you will not stop the transmission with the GRAY
  1517.     MINUS key because the PK-232 will then immediately switch to receive,
  1518.     regardless of still untransmitted text.  If you switch to receive
  1519.     with untransmitted text, you will get a warning message from PHS
  1520.     ("transmit data remaining"). This data will be sent the next time
  1521.     when you switch to transmit. However you have the option to flush the
  1522.     data by clearing the PK-232's transmit buffer with the GRAY-* key.
  1523.  
  1524.     Anytime you can insert a CTRL/D or CTRL/F into the text which you
  1525.     input. The PK-232 will switch to receive whenever it detects such a
  1526.     character (refer to the PK-232 manual) in the transmit data stream.
  1527.     Just a note: when you insert a CTRL/D followed by a carriage return
  1528.     (Enter-key), then you will get the transmit-data-remaining warning,
  1529.     because after switching to receive by the CTRL/D, the carriage return
  1530.     is still untransmitted.
  1531.  
  1532.     To start a Pactor QSO, press ALT/C and you will get a small window
  1533.     which lets you enter the other stations callsign.
  1534.  
  1535.     As soon as you are connected in Pactor, the other (remote) stations
  1536.     callsign will appear in the statusline. When you are transmitting
  1537.     during the qso and want to change-over, type CTRL-Y or press the END
  1538.     key to get the BTU-string which is:
  1539.  
  1540.         BTU <remote callsign> de <my callsign><CTRL-Y>
  1541.  
  1542.     If you are in Pactor-Listen mode and you have difficulties to monitor
  1543.     an Pactor-qso use the INS key to force a resynchronisation. If you are
  1544.     connected, the INS key forces an immediate (!) changeover.
  1545.  
  1546.  
  1547.     ALT/P in the pactor modes pops up the pactor-modes PK-232 parameter
  1548.     setup window:
  1549.  
  1550. ───────────────────────────────────────────────────────────────────────────────
  1551.  
  1552.                                                   ╒ PK-232 Parameters ╕
  1553.                                                   │                   │
  1554.                                                   │ CODE            2 │
  1555.                                                   │ MYPTCALL   HB9CVV │
  1556.                                                   │ PT200           Y │
  1557.                                                   │ PTHUFF          1 │
  1558.                                                   │                   │
  1559.                                                   │ <F1>  HELP        │
  1560.                                                   │ <ESC> EXIT        │
  1561.                                                   │ <F10> SET PARAM   │
  1562.                                                   │                   │
  1563.                                                   ╘═══════════════════╛
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  PACTOR LISTEN ║ RECEIVE  │  Phasing      ║              │    ║ 23-MAR 12:34:56
  1569.  
  1570.  
  1571. ───────────────────────────────────────────────────────────────────────────────
  1572.  
  1573.  
  1574.                                 RTTY MODE
  1575.                                 ─────────
  1576.  
  1577.     ALT/Z in rtty mode pops up the rtty-mode help screen:
  1578. ───────────────────────────────────────────────────────────────────────────────
  1579.   ╒════════════════════════════════ RTTY MODE ════════════════════════════════╕
  1580.   .                                     .                                     .
  1581.   .                                     .                                     .
  1582.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1583.   │ GRAY +  Transmit                    ║ GRAY *  Clear TNC transmit buffer   │
  1584.   │ GRAY -  Receive - immediate         ║ DEL     Force LETTERS case          │
  1585.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1586.   │ CTRL/D  Switch to receive           ║ CTRL/O  Send LETTERS character      │
  1587.   │ CTRL/F  Like CTRL/D, add CW-id      ║ CTRL/N  Send FIGURES character      │
  1588.   │ CTRL/B  Send " urcall de mycall "   ║ CTRL/T  Send date+time              │
  1589.   │                                     ║                                     │
  1590.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1591.  
  1592.  RECEIVE  ║ RTTY          ║                              │    ║ 23-MAR 12:34:56
  1593.  
  1594.  
  1595. ───────────────────────────────────────────────────────────────────────────────
  1596.  
  1597.     ALT/P in rtty mode pops up the rtty mode PK-232 parameter setup
  1598.     window:
  1599. ───────────────────────────────────────────────────────────────────────────────
  1600.  
  1601.                                                   ╒═ TNC Parameters ══╕
  1602.                                                   │                   │
  1603.                                                   │ ACRRTTY        72 │
  1604.                                                   │ CCITT           N │
  1605.                                                   │ CODE            0 │
  1606.                                                   │ CRADD           N │
  1607.                                                   │ DIDDLE          Y │
  1608.                                                   │ RBAUD          45 │
  1609.                                                   │ RXREV           N │
  1610.                                                   │ TXREV           N │
  1611.                                                   │ USOS            Y │
  1612.                                                   │ WIDESHFT        N │
  1613.                                                   │ WRU             N │
  1614.                                                   │                   │
  1615.                                                   │ <F1>  HELP        │
  1616.                                                   │ <ESC> EXIT        │
  1617.                                                   │ <F10> SET PARAM   │
  1618.                                                   │                   │
  1619.                                                   ╘═══════════════════╛
  1620. ────────────────────────────────── .... ───────────────────────────────────────
  1621.  
  1622.  
  1623.                                 ASCII MODE
  1624.                                 ──────────
  1625.  
  1626.     ALT/Z in the ascii mode pops up the ascii-mode help screen:
  1627. ───────────────────────────────────────────────────────────────────────────────
  1628.   ╒═══════════════════════════════ ASCII MODE ════════════════════════════════╕
  1629.   .                                     .                                     .
  1630.   .                                     .                                     .
  1631.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1632.   │ GRAY +  Transmit                    ║ GRAY *  Clear TNC transmit buffer   │
  1633.   │ GRAY -  Receive - immediate         ║                                     │
  1634.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1635.   │ CTRL/D  Switch to receive           ║ CTRL/F  Like CTRL/D, add CW-id      │
  1636.   │ CTRL/B  Send "urcall de mycall"     ║ CTRL/T  Send date+time              │
  1637.   │                                     ║                                     │
  1638.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1639.  
  1640.  RECEIVE  ║ ASCII         ║                              │    ║ 23-MAR 12:34:56
  1641.  
  1642.  
  1643. ───────────────────────────────────────────────────────────────────────────────
  1644.  
  1645.     ALT/P in ascii mode pops up the ascii mode PK-232 parameter setup
  1646.     window:
  1647. ───────────────────────────────────────────────────────────────────────────────
  1648.  
  1649.                                                   ╒═ TNC Parameters ══╕
  1650.                                                   │                   │
  1651.                                                   │ ABAUD         300 │
  1652.                                                   │ ACRRTTY        72 │
  1653.                                                   │ DIDDLE          Y │
  1654.                                                   │ RXREV           N │
  1655.                                                   │ TXREV           N │
  1656.                                                   │ WIDESHFT        N │
  1657.                                                   │ WRU             N │
  1658.                                                   │                   │
  1659.                                                   │ <F1>  HELP        │
  1660.                                                   │ <ESC> EXIT        │
  1661.                                                   │ <F10> SET PARAM   │
  1662.                                                   │                   │
  1663.                                                   ╘═══════════════════╛
  1664. ────────────────────────────────── .... ───────────────────────────────────────
  1665.  
  1666.  
  1667.                                 MORSE MODE
  1668.                                 ──────────
  1669.  
  1670.     ALT/Z in the morse mode pops up the morse-mode help screen:
  1671. ───────────────────────────────────────────────────────────────────────────────
  1672.   ╒═══════════════════════════════ MORSE MODE ════════════════════════════════╕
  1673.   .                                     .                                     .
  1674.   .                                     .                                     .
  1675.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1676.   │ GRAY +  Transmit                    ║ INS     Unlock receive speed (WPM)  │
  1677.   │ GRAY -  Receive - immediate         ║ DEL     Lock receive speed (WPM)    │
  1678.   │ GRAY *  Clear TNC transmit buffer   ║                                     │
  1679.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1680.   │ CTRL/D  Switch to receive           ║ CTRL/B  Send "urcall de mycall"     │
  1681.   │ CTRL/T  Send date+time              ║                                     │
  1682.   │                                     ║                                     │
  1683.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1684.  
  1685.  RECEIVE  ║ MORSE         │ 20 WPM ║                     │    ║ 23-MAR 12:34:56
  1686.  
  1687.  
  1688. ───────────────────────────────────────────────────────────────────────────────
  1689.  
  1690.     ALT/P in morse mode pops up the morse mode PK-232 parameter setup
  1691.     window:
  1692. ───────────────────────────────────────────────────────────────────────────────
  1693.  
  1694.                                                   ╒═ TNC Parameters ══╕
  1695.                                                   │                   │
  1696.                                                   │ MSPEED         20 │
  1697.                                                   │ MWEIGHT        10 │
  1698.                                                   │                   │
  1699.                                                   │ <F1>  HELP        │
  1700.                                                   │ <ESC> EXIT        │
  1701.                                                   │ <F10> SET PARAM   │
  1702.                                                   │                   │
  1703.                                                   ╘═══════════════════╛
  1704. ────────────────────────────────── .... ───────────────────────────────────────
  1705.  
  1706.  
  1707.                                 SIGNAL MODE
  1708.                                 ───────────
  1709.  
  1710.     ALT/Z in the signal mode pops up the signal-mode help screen:
  1711. ───────────────────────────────────────────────────────────────────────────────
  1712.  
  1713.   ╒═══════════════════════════════ SIGNAL MODE ═══════════════════════════════╕
  1714.   .                                     .                                     .
  1715.   .                                     .                                     .
  1716.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1717.   │ INS     Ok - accept & switch        ║                                     │
  1718.   │ ─────────────── NOTE ────────────── ║                                     │
  1719.   │    DO NOT SWITCH TO FAX or NAVTEX   ║                                     │
  1720.   │                                     ║                                     │
  1721.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1722.  
  1723.  
  1724.  
  1725.  RECEIVE  ║ SIGNAL                                       │    ║ 23-MAR 12:34:56
  1726.  
  1727.  
  1728. ───────────────────────────────────────────────────────────────────────────────
  1729.  
  1730.     Please do not switch to an unsupported mode (FAX or NAVTEX), it will
  1731.     not work.
  1732.  
  1733.     There is no signal mode PK-232 parameter setup window.
  1734.  
  1735.  
  1736.  
  1737.     Finally, the secret ALT-key:
  1738.  
  1739.     Whenever you give ALT/A, any incoming message to the currently
  1740.     selected window is accompanied by a deep summing tone. Another ALT/A
  1741.     disables the sound. There is no visible indication of ALT/A, because
  1742.     obviously there is an audible one.  I often use ALT/A when my partner
  1743.     says "wait a minute", because I have no klicking relais in my TRX
  1744.     which would attract my attention after that minute. Obviously, ALT/A
  1745.     should be avoided in non-packet modes...
  1746.  
  1747.  
  1748.  
  1749.                         THE CONFIGURATION FILE
  1750.                         ══════════════════════
  1751.  
  1752.     PHS reads the configuration file whenever you start PHS.  The
  1753.     configuration file contains information about hardware and software
  1754.     parameters. If this information is not accurate, PHS will be unable
  1755.     to proceed.
  1756.  
  1757.     You must edit the file PHS.CFG to reflect your hardware
  1758.     configuration, callsigns and texts. If you are not able to edit a
  1759.     text-file you cannot operate PHS.
  1760.  
  1761.     Here is an example of a configuration file:
  1762.  
  1763. ───────────────────────────────────────────────────────────────────────────────
  1764.     Devicetype = 4              ; PK-900.
  1765.     Callsign   = HB9CVV         ; My callsign
  1766.     ;PTCallsign = HB9CVV/A      ; My Pactor callsign (optional)
  1767.     Selcall    = HCVV           ; My selcall
  1768.     Comport    = COM4           ; COMport name
  1769.     Baudrate   = 9600           ; The baudrate
  1770.     UseRS232Controls        = YES
  1771.     ChannelMwindowsize      = 200
  1772.     Channel1Windowsize      = 200
  1773.     Channel2Windowsize      = 100
  1774.     Channel3Windowsize      = 100
  1775.     Channel4Windowsize      =  50
  1776.     ChannelM2windowsize     = 200    ; Channel M2 and A-D for PK-900 only.
  1777.     ChannelAWindowsize      = 200
  1778.     ChannelBWindowsize      = 100
  1779.     ChannelCWindowsize      = 100
  1780.     ChannelDWindowsize      =  50
  1781.     StartupPK232mode    = 2
  1782.     EditorColumnSize        = 70
  1783.     EditorRowSize        = 0
  1784.     MFILTERenabled          = NO
  1785.     UTCoffsethours        = -1
  1786.     Polldelay        = 50
  1787.     ResetDeviceOnExit       = YES
  1788.     Skip_ParamInit          = NO
  1789.  
  1790.     CommandString           = C DK1SL VIA HB9F
  1791.     CommandString           = C HB9SDD
  1792.     CommandString           = C HB9PD
  1793.     CommandString           = C HB9PD VIA HB9PD-7
  1794.  
  1795.     StartupDeviceCmd    = MYALIAS BIENNE
  1796.     StartupDeviceCmd    = TXREV YES
  1797.     StartupDeviceCmd    = RXREV NO
  1798.     StartupDeviceCmd    = TXDELAY 30/50
  1799.  
  1800.     ConnectMsg = Operator is OFFLINE, this message is recorded...
  1801.     BeaconText = *** Peter, Qth: Port/Biel - JN37OC ***
  1802.  
  1803.     F01KeyTitle = Name & Qth
  1804.     F01KeyText = My name is Peter, the QTH is Port, 20 miles west...
  1805.  
  1806.     F02KeyTitle = Rig SHORT
  1807.     F02KeyText = -
  1808.     The rig here is: a 486/33-PC, PK-900, Yaesu FT-990, 100W to a GP. -
  1809.     I am using my own PK-232/900 Hostmode Server (PHS) program under OS/2.
  1810.  
  1811.     F03KeyTitle = Rig LONG
  1812.     F03KeyText = -
  1813.     The rig here is:-
  1814.     -----------------------------------------------------------
  1815.     Programs  : THS (TNC Hostmode Server - OS/2) V6.0-
  1816.                 PHS (PK-232/900 Hostmode Server - OS/2) 6.0.-
  1817.     Computers : (1) 486/33, 16MB RAM, 660MB disk, OS/2 2.1.-
  1818.                 (2) 486/33, 16MB RAM, 660MB disk, OS/2 2.0.-
  1819.     TRX       : FT-990, 100W.-
  1820.                 TW-4100E, 45W.-
  1821.     Antenna   : DX-2000 GP for HF.-
  1822.                 X-300 2m/70cm vertical.-
  1823.     TNC       : TNC-1 with TNC-2 board and WA8DED firmware.-
  1824.                 PK-232 with Pactor firmware.-
  1825.                 PK-900 with Pactor firmware.-
  1826.     -----------------------------------------------------------
  1827.     In use: PHS, 486/33, PK-900, FT-990, GP.
  1828.  
  1829.     F05KeyTitle = FEC CQ
  1830.     F05KeyText = -
  1831.     4 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)-
  1832.     3 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)-
  1833.     2 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)-
  1834.     1 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)-
  1835.     SELCAL HCVV HCVV HCVV - PSE KKKKK-
  1836.     (
  1837.  
  1838.     F06KeyTitle = RYRYRY
  1839.     F06KeyText = RYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRY
  1840.  
  1841.     F07KeyTitle = Pactor CQ
  1842.     F07KeyText = -
  1843.     4 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV-
  1844.     3 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV-
  1845.     2 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV-
  1846.     1 CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV-
  1847.     PSE KKKKK-
  1848.     (
  1849.  
  1850.     ReceiveWindow_Text        = Green on Black
  1851.     TransmitWindow_Text             = Cyan on Black
  1852.     StatuslineText                  = White on Blue
  1853.     Review_Text                     = White on Blue
  1854.  
  1855.     ServiceWindow_Border            = White on Blue
  1856.     ServiceWindow_Text              = Blue on lightgrey
  1857.  
  1858.     CommandEntry_Border             = White on Black
  1859.     CommandEntry_Text               = Yellow on Red
  1860.     CommandEntry_InactiveField      = Yellow on Green
  1861.     CommandEntry_ActiveField        = Yellow on Green
  1862.  
  1863.     ParameterDialog_Border          = LightGreen on Black
  1864.     ParameterDialog_Text            = Black on lightgrey
  1865.     ParameterDialog_InactiveField   = Blue on Lightgrey
  1866.     ParameterDialog_ActiveField     = White on Blue
  1867.  
  1868.     ParameterHelp_Border            = White on Blue
  1869.     ParameterHelp_Text              = Lightcyan on Blue
  1870.  
  1871.     FileXfer_Border                 = Black on lightgrey
  1872.     FileXfer_Text                   = White on Brown
  1873.  
  1874.     EditorWindow_Border             = White on Blue
  1875.     EditorWindow_Text               = Yellow on Blue
  1876.     EditorWindow_ActiveField        = Yellow on Red
  1877.  
  1878.     HeardList_Border                = LightRed on Brown
  1879.     HeardList_Text                  = White on Brown
  1880.  
  1881.     ;OnScreenChannelId               = LightBlue on Lightgrey
  1882.     OnScreenChannelId               = White on Blue
  1883.     OffScreenChannelId              = Cyan on Blue
  1884.     OffScreenChannelIdData          = Yellow on Blue
  1885.     SentTextInReceiveWindow         = default
  1886.     EchoAsSentText            = default
  1887.  
  1888. ───────────────────────────────────────────────────────────────────────────────
  1889.  
  1890.     All lines have the format: KEYWORD = PARAMETER and are not case
  1891.     sensitive. A semicolon must preceed comments. If a line ends with a
  1892.     dash ('-'), then the dash is replaced by a newline character and the
  1893.     following line is appended.  This feature is used for multi-line text
  1894.     string parameters.
  1895.  
  1896.     There are mandatory and optional keywords. The CALLSIGN keyword
  1897.     (obviously) is mandatory, CHANNEL1_WINDOWSIZE is not - if you omit an
  1898.     optional keyword, you get the defaults.
  1899.  
  1900.     "DeviceType"
  1901.  
  1902.         Use '1' if you use a TNC-1 with the WA8DED (or equivalent)
  1903.         firmware, a '2' for a TNC-2 with the WA8DED firmware, a '3'
  1904.         for the PK-232 and a '4' for a PK-900. Mandatory.
  1905.  
  1906.     "Callsign" and "Selcall"
  1907.  
  1908.         You guessed it. Both are mandatory for PHS, for THS, only
  1909.         "Callsign" is mandatory.
  1910.  
  1911.     "PTCallsign"
  1912.  
  1913.         Callsign for Pactor. Defaults to "Callsign".
  1914.  
  1915.     "Comport" and "Baudrate"
  1916.  
  1917.         The Comport name and the baudrate to be used. Mandatory.
  1918.  
  1919.     "UseRS232Controls"
  1920.  
  1921.         Use 'NO' if you only have a 3-wire connection. Optional, the
  1922.         default is YES.
  1923.  
  1924.     "ChannelMwindowsize", "Channel1windowsize", "Channel2windowsize",
  1925.     "Channel3windowsize" and "Channel4windowsize"
  1926.  
  1927.         Number of lines for the monitor channel and the four
  1928.         operating channels. Optional, the default for each is 200.
  1929.  
  1930.     "StartupPK232mode"
  1931.  
  1932.         You can select the initial PK-232 mode here. The mode numbers
  1933.         are 0 to 9 for Packet-VHF, Packet-HF, Amtor-Listen,
  1934.         Amtor-Standby, RTTY, Ascii, Morse, Signal, Pactor-listen and
  1935.         Pactor-Standby mode.  This is the mode which the PK-232 should
  1936.         enter immediately after startup.  Optional, PHS only. The
  1937.         default is 2 for Amtor-Listen.
  1938.  
  1939.         If RESETONDEVICEEXIT is NO, you will instead get the actual
  1940.         device's mode.
  1941.  
  1942.     "EditorColumnSize" and "EditorRowSize"
  1943.  
  1944.         Defines the editor window size, columns and rows. The range
  1945.         for the column is 64 to 79, and includes the window border.
  1946.         If a given value exceeds one of the limits, then the
  1947.         according limit value is taken.  If you omit this parameter,
  1948.         or specify a zero, then the default value of 76 is taken. The
  1949.         range for the row depends on the size of the (upper) receive
  1950.         window, which itself depends on the number of lines of your
  1951.         current video mode. The range if from half that window to
  1952.         full size minus one. For the standard 25 line mode, the range
  1953.         is 10 to 20, also including the border.  The default here is
  1954.         the lowest value, i.e. half the size of the receive window.
  1955.  
  1956.     "MFILTERenabled"
  1957.  
  1958.         This determines the initial value of the MFILTER variable,
  1959.         see the description of the ALT/T command.  "NO" disables the
  1960.         filtering, "YES" enables it.  Optional, the default (e.g. if
  1961.         omitted) is NO.
  1962.  
  1963.     "BELLenabled"
  1964.  
  1965.         This determines the initial value of the BELL variable,
  1966.         see the description of the ALT/T command. "NO" disables the
  1967.         filtering, "YES" enables it. Optional, the default (e.g. if
  1968.         omitted) is "NO".
  1969.  
  1970.     "UTCoffsethours"
  1971.  
  1972.         During startup, PHS gets the current system time of your PC,
  1973.         adds the "UTCoffsethours", and loads this date and time into
  1974.         the PK-232. The intention is to have the PK-232 loaded with
  1975.         the UTC rather than with the local time - in case you want to
  1976.         use the CTRL/T feature of the PK-232 to send date and time.
  1977.         Note however that if there is a non-zero UTC offset
  1978.         specified, then the link status messages (e.g.  "CONNECTED
  1979.         to") are always time-stamped by the PK-232 and will
  1980.         consequently show the PK-232s time. This time differs by the
  1981.         offset hours from the time on the status line of PHS.
  1982.  
  1983.         The date/time of the PK-232 is refreshed every full hour by
  1984.         PHS because the PC's clock is more accurate that the PK-232
  1985.         clock.
  1986.  
  1987.         Optional, PHS only. The default is zero.
  1988.  
  1989.     "Polldelay"
  1990.  
  1991.         To avoid an excessive system load, THS/PHS does not poll
  1992.         the device continuosly but inserts small delays between
  1993.         successive polls. You may somewhat finetune Systemload vs
  1994.         THS/PHS performance here.  The range is 1 to 999 mS.
  1995.  
  1996.         Optional, the default is 50 (mS). You can change this
  1997.         parameter also online in the ALT-T window.
  1998.  
  1999.         Note however that when THS/PHS is run in an AVIO window, 
  2000.         considerable CPU time may be needed for the text display 
  2001.         (depending how fast your video system is).
  2002.  
  2003.     "ResetDeviceOnExit"
  2004.  
  2005.         Normally, THS and PHS will reset the device during startup,
  2006.         to get clean conditions for the price of loosing all stored
  2007.         information. If ResetDeviceOnExit is NO, then THS/PHS does
  2008.         not reset the device but tries to derive the devices current
  2009.         state. This is however not fail safe under all conditions.
  2010.         The preferred value for this optional parameter is the
  2011.         default of YES.
  2012.  
  2013.     "Skip_Paraminit"
  2014.  
  2015.         If NO, then PHS/THS does not load the parameters during
  2016.         startup. Not doing this, the device can be in a state
  2017.         where the operation of PHS will fail. You should set
  2018.         this parameter only to NO when you have used PHS/THS
  2019.         for a while and do not use other terminal programs
  2020.         which might modify these parameters to their own use.
  2021.  
  2022.     "CommandString"
  2023.  
  2024.         The parameter is a text string and must contain a valid TNC
  2025.         or PK-232 command.  Up to 20 "CommandString" lines with a
  2026.         text not exceeding 72 characters are possible.  They are
  2027.         stored by THS/PHS and presented together with a selection
  2028.         character when you press ALT/W.  When you press the selection
  2029.         character or move the bar to the desired entry, then the
  2030.         associated string is sent as a command to the on-screen
  2031.         channel. Intended to build a call-sign directory for
  2032.         connects, you may however use other commands there as well,
  2033.         so it is called "Command String Directory". CommandStrings
  2034.         are optional.
  2035.  
  2036.         THS users note: The TNC commands use the TAPR syntax, NOT the
  2037.         more cryptic WA8DED syntax.
  2038.  
  2039.     "StartupDeviceCmd"
  2040.  
  2041.         You can specify up to 10 StartupDeviceCmd lines. The
  2042.         parameter text must not exceed 40 characters and is sent as
  2043.         command to the TNC/PK-232 when THS/PHS loads the TNC/PK-232
  2044.         parameters during startup.
  2045.  
  2046.         This is done *after* THS/PHS has sent the default set of
  2047.         parameter commands and so allows the user to override the
  2048.         default parameter set of THS/PHS.  You should however take
  2049.         some care - the text is sent must be a valid command and can
  2050.         only contain a command which does not interfere with THS/PHS
  2051.         operation. The non-interfering commands which appear in the
  2052.         ALT/P windows. Optional.
  2053.  
  2054.     "ConnectMsg"
  2055.  
  2056.         The parameter text is your connect message, and may not
  2057.         exceed 72 characters, if it does, then the text is truncated.
  2058.         This text is loaded connect message any time online.
  2059.         Mandatory.
  2060.  
  2061.     "BeaconText"
  2062.  
  2063.         The parameter text is your beacon text, and may not exceed 72
  2064.         characters, if it does, then the text is truncated. This text
  2065.         is loaded into the TNC/PK-232 when THS/PHS is started. You
  2066.         can however alter your cbeacon text any time online.
  2067.         Mandatory.
  2068.  
  2069.     "F01KeyTitle" & "F01KeyText" to "F10KeyTitle" & "F10KeyText"
  2070.  
  2071.         The function key title string and the function key text is
  2072.         assigned to the appropriate function key. The keytitle string
  2073.         is a descriptor text (up to 30 characters), the keytext
  2074.         string cannot exceed 1000 characters. The keytext strings are
  2075.         intended for reasonable sized texts like station descriptions
  2076.         or cq calls.
  2077.  
  2078.         When you press ALT/F then THS/PHS shows the titles of the
  2079.         text strings in a window box. The titles also come up when
  2080.         you press a function key which has nothing assigned.
  2081.  
  2082.         When you press a function key to which a text has been
  2083.         assinged, THS/PHS will send this text string to the
  2084.         TNC/PK-232.
  2085.  
  2086.         The function-key text must contain only printable characters,
  2087.         and two characters have a special meaning: The '(' character
  2088.         at the end of a line (and only at the end of a line !) is
  2089.         translated into CTRL/D when PHS reads the line.  The '<'
  2090.         character is translated into CTRL/F (if at the end of a
  2091.         line).  CTRL/D and CTRL/F are used by the PK-232 to switch to
  2092.         receive when embedded in text.
  2093.  
  2094.         In the sample CFG-file you find a FEC-cq call. The single
  2095.         line with the opening-bracket character (which is at the end
  2096.         of that line) is translated into CTRL/D and the PK-232 will
  2097.         switch to receive at the end of this cq-call.
  2098.  
  2099.         All FxxKeyTitle and FxxKeyText keywords are optional.
  2100.  
  2101.     The COLOR keywords.
  2102.  
  2103.         The (mandatory) color keywords are used to define the
  2104.         appearance of THS/PHS. You may alter the parameters to fit
  2105.         your taste. The parameters have the form
  2106.  
  2107.             <foreground color> on <background color>
  2108.  
  2109.         Possible colors are:
  2110.  
  2111.             Foreground      Background
  2112.  
  2113.             BLACK        BLACK
  2114.             BLUE        BLUE
  2115.             GREEN        GREEN
  2116.             CYAN        CYAN
  2117.             RED        RED
  2118.             MAGENTA        MAGENTA
  2119.             BROWN        BROWN
  2120.             LIGHTGRAY    LIGHGRAY
  2121.             DARKGRAY    |
  2122.             LIGHTBLUE    |
  2123.             LIGHTGREEN    |
  2124.             LIGHTCYAN    |- not for background
  2125.             LIGHTRED    |
  2126.             LIGHTMAGENTA    |
  2127.             YELLOW        |
  2128.             WHITE        |
  2129.  
  2130.     "OnScreenChannelId"
  2131.     "OffScreenChannelId"
  2132.     "OffScreenChannelIdData"
  2133.  
  2134.         On the left side of the statusline in the Packet-mode are the
  2135.         channel indicators: the string "M1234" - for the monitor
  2136.         channel and the channels one to four. One of these channels
  2137.         is visible on-screen, all others are off-screen. You use the
  2138.         left and right arrow keys to get the desired channel
  2139.         on-screen. Because all channels are always active, an
  2140.         off-screen channel may receive date any time.
  2141.  
  2142.         "OnScreenChannelId" defines the color attributes of the
  2143.         on-screen channel, "OffscreenChannelId" defines the color
  2144.         attributes for an off-screen channel which has not got new
  2145.         received data, and "OffscreenChannelIdData" defines the color
  2146.         attributes for an off-screen channel which has got new data.
  2147.  
  2148.         Whenever an off-screen channel receives new, unseen (because
  2149.         it is off-screen) data, then, to give you an indication, the
  2150.         color attribute changes from "OffScreenChannelId" to
  2151.         "OffscreenChannelIdData".
  2152.  
  2153.     "SentTextInReceiveWindow"
  2154.  
  2155.         In all modes, the text you type is echoed in the lower
  2156.         (transmit) window.  In the packet mode, when you send the
  2157.         text by typing a carriage return, the text is moved to the
  2158.         upper (receive) window, and the transmit window is cleared.
  2159.         THS/PHS uses different attributes so you can easily
  2160.         distinguish the text which you sent from the text you
  2161.         receive.  By default, the text sent has the same text and
  2162.         background color as the received text, but is intensified.
  2163.         This is what you get if you specify "SentTextInReceiveWindow
  2164.         = Default". If specify a color instead, THS/PHS will use
  2165.         these color attributes.
  2166.  
  2167.         Example:  if you have defined "ReceiveWindow_Text = Green on
  2168.         Black" and you want your text reversed, not intensified, then
  2169.         define "SendTextInReceiveWindow = Black on Green" here.
  2170.  
  2171.     "SentTextInTransmitWindow"
  2172.  
  2173.         In the non-packet modes, the entered text for transmission is
  2174.         sent to the PK-232 word-by-word and you get the echo in the
  2175.         receive window from the PK-232 (echo-as-sent) when it is
  2176.         actually transmitted.
  2177.  
  2178.         For to get an indication up to which part of your text has
  2179.         already been sent to the PK-232 (and not yet transmitted),
  2180.         that part is highlighted in the TRANSMIT window if you
  2181.         specify "Default". If you prefer another presentation, you
  2182.         can experiment with color values.
  2183.  
  2184.         Mandatory, PHS only.
  2185.  
  2186.  
  2187.  
  2188.                         ERROR REPORTS
  2189.                         ═════════════
  2190.  
  2191.     Whenwever PHS detects an error, it will open a window and display an
  2192.     error message and optionally parameters. Note that it is not always
  2193.     possible to recover from these errors. The message types are
  2194.  
  2195.             RS-232 Port Overrun error
  2196.             RS-232 Port Parity error
  2197.             RS-232 Port Framing error
  2198.             RS-232 Port BREAK interrupt
  2199.             Hostmode waiting for SOH: timeout
  2200.             Hostmode waiting for databyte: timeout
  2201.             Hostmode excessive input, no ETB
  2202.             Unknown error during input, code: nnnn
  2203.  
  2204.     The RS-232 errors are signalled by the OS/2 communications device
  2205.     driver.
  2206.  
  2207.     Parity and framing errors, or break interrupt may indicate a chip
  2208.     problem, this could however be on either end of the serial line. Try
  2209.     to use another port on the PC, and/or reduce the transmission baud
  2210.     rate.
  2211.  
  2212.     Whenever you get an overrun error this indicates that the your PC is
  2213.     not fast enough to process the incoming characters. This can be
  2214.     solved by either reducing the frequency in which the incoming
  2215.     characters appear, i.e. by reducing the communications baudrate, or
  2216.     by using a more sophisticated serial communications controller chip,
  2217.     or by increasing the CPU speed.
  2218.  
  2219.     The "hostmode" errors signal a problem with the PHS-PK-232 hostmode
  2220.     communication. Up to now I have ever only seen the first one (timeout
  2221.     waiting for SOH), and only during startup of PHS. A hardware reset of
  2222.     the PK-232 and or a hardware (!) reset of the PC cured it (on the PC
  2223.     side, a CTRL-ALT-DEL will not help).
  2224.  
  2225.                        DECODING OF NET/ROM FRAMES
  2226.                        ══════════════════════════
  2227.  
  2228.     PHS decodes Net/Rom routing broadcast messages and the inter-node
  2229.     frames into a plain English text format. For an interpretation of the
  2230.     various variables shown, please refer to "Net/Rom Version 1.3
  2231.     Documentation" from Software 2000 Inc.
  2232.  
  2233.                               FINAL REMARKS
  2234.                               ═════════════
  2235.  
  2236.     I will be interested in your proposals and comments. Please note
  2237.     however that I will feel no obligation of any kind. I am a
  2238.     professinal software designer, but THIS is a hobby project.
  2239.  
  2240.     My address is:          Peter H. Heinrich
  2241.                                  HB9CVV
  2242.                             Allmendstr. 25
  2243.                             CH-2562 Port
  2244.                             Switzerland
  2245.  
  2246.     You can also contact me on CompuServe [71470,32].
  2247.  
  2248.  
  2249.                              REVISION HISTORY
  2250.                              ════════════════
  2251.  
  2252.     2.xx    1988            Releases of THS (DOS)
  2253.     3.00    October 1989    Initial release (PHS for DOS)
  2254.     4.00    October 1991    Beta release (PHS/THS for OS/2)
  2255.             February 1992   Inital release (PHS/THS for OS/2)
  2256.     5.00    March 1993      Internal release
  2257.     6.00    May 1993        Beta release (PHS/THS for OS/2 2.x).
  2258.  
  2259.  
  2260.  
  2261.                 PK-900
  2262.                                 ══════
  2263.  
  2264.  
  2265.         ******************************************************************
  2266.         * A note to PK-900 users: It is highly recommended NOT to use    *
  2267.         * the PK-900 at a communication line speed of 19200 baud, but    *
  2268.         * use 9600 baud only. The PK-900 seems to have problems at 19200 *
  2269.         * baud (which can be seen by the use of a line monitor).         *
  2270.         ******************************************************************
  2271.  
  2272.                                                                          
  2273.     To enable the proper operation for a PK-900, you must set a             
  2274.     devicetype of 4 in the configuration file.
  2275.  
  2276.     The statusline for the PK-900 will be slightly different to reflect
  2277.     the operation of the second modem ("Radio 2"). This is what you see
  2278.     when Radio 1 is in Amtor-Listen mode and this channel is selected:
  2279.  
  2280.  AMTOR LISTEN   ║ RECEIVE  │ Phasing     ║              ║    ║ MABCD ║ 19:09:03
  2281.  
  2282.     The MABCD string contains the channel indicators of the four
  2283.     channels of Radio 2 (A, B, C, and D) and the monitor channel for
  2284.     Radio 2 (M). To select one of these channels, use the left or right
  2285.     arrow keys. The statusline will change to:
  2286.  
  2287.   1    ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED              ║    ║ MABCD ║ 19:15:21
  2288.  
  2289.     and one of the indicators (MABCD) is highlit to show which channel
  2290.     is currently selected. The single "1" is the indicator of the Radio
  2291.     one channel - in non-packet modes, there is only one channel.
  2292.  
  2293.     If you have a Radio-2 channel selected, the mode-swich command (by
  2294.     ALT/M) will allow you to change between Packet-VHF and Packet-HF
  2295.     only - other modes are available only on Radio-1.
  2296.  
  2297.     If you are on a Radio-1 channel, and switch the mode to Packet, the
  2298.     status line will be like this:
  2299.  
  2300.  M1234 ║ HF  ║ UA:00 RTY:00 │ DISCONNECTED              ║    ║ MABCD ║ 19:23:24
  2301.  
  2302.     Again, one of the indicators either on one of the Radio-1 channels
  2303.     (M1234) or of the Radio-2 channels (MABCD) is highlit to indicate
  2304.     the currently active channel. Use the left or right arrow keys to
  2305.     change to another channel.
  2306.  
  2307.     PHS maintains two different heard-lists, one for each radio of the
  2308.     PK-900. Whenever you type ALT/H or ALT/G, the heardlist for the
  2309.     currently selected radio is shown.
  2310.  
  2311.     When ALT/I is pressed, then PHS shows twelve entries in the selection
  2312.     list for the PK-900 - CFROM-2, DFROM-2, MFROM-2 and MTO-2 is added for
  2313.     Radio-2.
  2314.  
  2315.     Please also remember that most of the packet-related PK-900 commands
  2316.     have now two parameters, seperated by a slash ("/") where the first
  2317.     parameter applies to RADIO 1, and the second parameter after the slash
  2318.     is for RADIO 2. Consequently, if you press ALT-P on a packet-channel,
  2319.     you get something like this:
  2320.  
  2321. ────────────────────────────────── .... ───────────────────────────────────────
  2322.  
  2323.       ╒════════════════════ PK-900 Parameters ════════════════════╕
  2324.           │                                                           │
  2325.       │ ACKPRIOR      Y/Y   FULLDUP       N/N   RESPTIME      0/0 │
  2326.       │ AUDELAY       2/2   HID           N/N   RETRY       10/10 │
  2327.       │ AX25L2V2      Y/Y   LITE          N/N   SLOTTIME    30/30 │
  2328.       │ AXDELAY       0/0   MAXFRAME      4/4   SQUELCH       N/N │
  2329.       │ AXHANG        0/0   MCON          6/6   TRIES           0 │
  2330.       │ BARGRAPH        0   MID           0/0   TXDELAY     30/50 │
  2331.       │ BEACON    E 0/E 0   MODEM         4/4   USERS         2/2 │
  2332.       │ BRIGHT         50   MONITOR       6/6   WHYNOT          N │
  2333.       │ CHECK       25/25   MRPT          Y/Y   XMITOK          Y │
  2334.       │ CMSG          N/N   MSTAMP          N                     │
  2335.       │ CONPERM         N   PASSALL       N/N   <F1>  HELP        │
  2336.       │ DWAIT       16/16   PERSIST     84/84   <ESC> EXIT        │
  2337.       │ FRACK         5/8   PPERSIST      Y/Y   <F10> SET PARAM   │
  2338.       │ FRICK         0/0   RELINK        N/N                     │
  2339.       │                                                           │
  2340.       ╘═══════════════════════════════════════════════════════════╛
  2341.  
  2342.  1    ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED              ║    ║ MABCD ║ 19:30:29
  2343.  
  2344.  Eable acknowledgement priority (Y/N)
  2345. ────────────────────────────────── .... ───────────────────────────────────────
  2346.  
  2347.     In the Config-file, there are now five more keywords - ChannelM2size
  2348.     and ChannelAsize to ChannelDsize for the new channels of Radio-2.
  2349.  
  2350.     Please note that the help-text for the commands is no longer
  2351.     complete.  A long time ago I got the PK-232 command summary from AEA,
  2352.     this was then used for the helptext. Unfortunately, it is no longer
  2353.     possible to get this from AEA, and I do not like to type always the
  2354.     latest command summary from the manuals. I did it for some commands,
  2355.     but got tired to do this for all. Thanks for your understanding...
  2356.  
  2357.     When the RESETdeviceonexit parameter of the Config-file is ON (which
  2358.     is the (recommended) default) then PHS switches both radios OFF on
  2359.     exit, and (always) ON when started. This means that the RADIO 1 and
  2360.     RADIO 2 indicators of the PK900 LCD panel go off when PHS exits. In
  2361.     case you want to operate the PK900 with another program, you must
  2362.     first issue a "RADIO 1/2" command to enable both radios (modems).
  2363.  
  2364.     Version 6.01 and higher has the ALT-1 and ALT-2 keys to toggle
  2365.     Radio-1 or Radio-2 on/off. However, it is possibly not wise to
  2366.     switch a modem off during a qso...
  2367.  
  2368. ───────────────────────────── end of file ─────────────────────────────────────
  2369.                   so far.
  2370.